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The OS/2 Debug Handbook Library 


The following information describes the four volumes that comprise the OS/2 
Debug Handbook library. The graphic of the opened book denotes the volume 
that you are currently reading. 


Volume |, Basic Skills and Diagnostic Techniques, SG24-4640. 


This volume introduces the concepts of debugging with practical examples. Also 
contained in this book is a CDROM version of the entire library, which is 
viewable via the OS/2 INF View utility. 


Volume Il, Using the Debug Kernel and Dump Formatter, SG24-4641. 


This volume provides necessary information to set up and use the Kernel Debug 
and Dump Formatter tools. Also this guide serves as a command reference for 
these products. 


Volume Ill, System Trace Reference, SG24-4642. 


This volume includes all system tracepoints contained within OS/2. 


Volume IV, System Diagnostic Reference, SG24-4643. 


This volume provides details of internal structures used by OS/2. 
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Abstract 


This publication is volume four, which is one of four volumes that together 
provide information and reference materials intended to help perform OS/2 
debugging. 


This volume provides system reference and control block information that is 
used within OS/2. It is intended that this volume be used only in conjunction 


with the other volumes in the library. 


This document is intended for use by service personnel, system programmers 
and software developers. 


(286 pages) 
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Preface 


This volume of the OS/2 Debugging Handbook Library is a reference to the 
Reliability Availability and Serviceability interfaces, OS/2 system control blocks 
and other reference tables. This book should only be used in conjunction with 
the other volumes in this library. 


This document is intended for use by service personnel, system programmers 
and software developers. 


How This Document is Organized 


The document is organized as follows: 
¢ Chapter 1, “CONFIG.SYS RAS Commands” 


Details of the commands are in this chapter if they are not mentioned in the 
OS/2 Command Reference manual. 


* Chapter 2, “OS/2 RAS Application Programming Interfaces” 


Information pertaining to the application programming interfaces are 
described in this chapter. 


* Chapter 3, “OS/2 System Control Block Reference” 


This large section documents major control blocks that are defined by the 
base OS/2 system. 


* Chapter 4, “Reference Tables” 


This section documents various system tables, system error codes and other 
miscellaneous tables. 


Related Publications 


Throughout this book we assume the availability and familiarity with three 
co-requisite publications: 


« The INTEL486 Microprocessor Programmer's Reference Manual, ISBN 
1-55512-159-4 


¢ The Intel Pentium Family User's Manual, Volume 3: Architecture and 
Programming Manual, ISBN 1-55512-227-2 


* The Design of OS/2 by H.M. Deitel and M.S. Kogan, ISBN 0-201-54889-5 
The publications listed in this section are considered particularly suitable for a 
more detailed discussion of the topics covered in this document. 


- The OS/2 Technical Library Control Program Programming Reference Version 
2.00, S10G-6263-00 


* OS/2 2.0 Proc Lang 2/REXX Ref, S10G-6268-00 

* OS/2 2.0 Proc Lang 2/REXX User Guide, S10G-6269-00 

* OS/2 WARP Control Program Programming Guide, G25H-7101-00 
* OS/2 WARP Control Program Programming Ref, G25H-7102-00 

* OS/2 WARP PM Basic Programming Guide, G25H-7103-00 
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OS/2 WARP PM Advanced Programming Guide, G25H-7104-00 
OS/2 WARP GPI Programming Guide, G25H-7106-00 

OS/2 WARP GPI Programming Ref, G25H-7107-00 

OS/2 WARP Workplace Shell Programming Guide, G25H-7108-00 
OS/2 WARP Workplace Shell Programming Ref, G25H-7109-00 

OS/2 WARP IPF Programming Guide, G25H-7110-00 

OS/2 WARP Tools Reference, G25H-7111-00 

OS/2 WARP Multimedia App Programming Guide, G25H-7112-00 
OS/2 WARP Multimedia Subsystem Programming, G25H-7113-00 
OS/2 WARP Multimedia Programming Ref, G25H-7114-00 

OS/2 WARP PM Programming Ref Vol I, G25H-7190-00 

OS/2 WARP PM Programming Ref Vol II, G25H-7191-00 

Technical Reference - Personal Computer AT, Part Number 1502494 
PS/2 and PC BIOS Interface Technical Reference, Part Number 68X2341 


International Technical Support Organization Publications 


XX 


OS/2 Debugging 


OS/2 Warp Connect, GG24-4505 

OS/2 Warp Generation, Vol.1, SG24-4552 

OS/2 Warp Version 3 and BonusPak, GG24-4426 

Multimedia in Warp, GG24-2516 

The Technical Compendium Volume 1 - Control Program, GG24-3730 


The Technical Compendium Volume 2 - DOS and Windows Environment, 
GG24-3731 


The Technical Compendium Volume 3 - Presentation Manager and Workplace 
Shell, GG24-3732 


The Technical Compendium Volume 4 - Application Development, GG24-3774 


A complete list of International Technical Support Organization publications, 
known as redbooks, with a brief description of each, may be found in: 


International Technical Support Organization Bibliography of Redbooks, 
GG24-3070. 


To get a catalog of ITSO redbooks, VNET users may type: 
TOOLS SENDTO WTSCPOK TOOLS REDBOOKS GET REDBOOKS CATALOG 


A listing of all redbooks, sorted by category, may also be found on MKTTOOLS 
as ITSOCAT TXT. This package is updated monthly. 


-— How to Order ITSO Redbooks 


IBM employees in the USA may order ITSO books and CD-ROMs using 
PUBORDER. Customers in the USA may order by calling 1-800-879-2755 or by 
faxing 1-800-445-9269. Most major credit cards are accepted. Outside the 
USA, customers should contact their local IBM office. Guidance may be 
obtained by sending a PROFS note to BOOKSHOP at DKIBMVM1 or E-mail to 
bookshop@dk.ibm.com. 


Customers may order hardcopy ITSO books individually or in customized 
sets, called GBOFs, which relate to specific functions of interest. IBM 
employees and customers may also order ITSO books in online format on 
CD-ROM collections, which contain redbooks on a variety of products. 


ITSO Redbooks on the World Wide Web (WWW) 


Internet users may find information about redbooks on the ITSO World Wide Web 
home page. To access the ITSO Web pages, point your Web browser (such as 
WebExplorer from the OS/2 3.0 Warp BonusPak) to the following URL: 


http://www. redbooks.ibm.com/redbooks 


IBM employees may access LIST3820s of redbooks as well. Point your web 
browser to the IBM Redbooks home page: 


http://w3.itsc.pok.ibm.com/redbooks/redbooks.html 
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Chapter 1. CONFIG.SYS RAS Commands 


OS/2 provides a number of CONFIG.SYS commands and settings specifically for 
RAS purposes. Some of these are described in the OS/2 Command Reference 
and will not be discussed in detail here. A number of commands were 
introduced or enhanced in APAR PJ12258, which is applicable to OS/2 2.11. All 
the commands described here are available with OS/2 Warp 3.0. 


The following CONFIG.SYS commands comprise the RAS set. Those not 
completely documented in the OS/2 Command Reference are now discussed in 
detail. 


- AUTOFAIL (see OS/2 Command Reference, autofail) 
* 1.2, “DUMPPROCESS” 

* 1.3, “REIPL” on page 2 

* 1.4, “SHAPIEXCEPTIONHANDLER” on page 2 

¢ 1.5, “SHELLEXCEPTIONHANDLER?” on page 3 

* 1.6, “SUPPRESSPOPUPS” on page 4 


* TRACE (see the OS/2 Command Reference). Also see the System Trace User 
Guide in Volume 3 of The OS/2 Debugging Library. 


« TRACEBUF (see the OS/2 Command Reference). 
* TRACEFMT (see the OS/2 Command Reference). 
- See also 1.10, “TRAPDUMP” on page 5. 


1.1 AUTOFAIL 


AUTOFAIL modifies the processing of media errors. See the OS/2 Command 
Reference, AUTOFAIL command. 


1.2 DUMPPROCESS 


This command allows the user to activate the process dump facility. When 
active, any ring 3 (application) process that traps will result in a memory dump 
being written to a unique dump file. The dump file takes a name of the form 
PDUMP.nnn where nnn is an index that is incremented each time a new process 
dump is created. 


The contents of the dump comprise unformatted system and user storage that 
relates to the trapping process. Included in this are: 

- PTDA 

* TCB and TSD 

« Registers 

« Arena records 

+ MTE and SMTEs 

+ LDT 

- Ring 0 stack 
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« Ring 3 stack 
Syntax 


DUMPPROCESS=x 


Parameters 


x This specifies the drive letter (excluding the colon) to which process dump 
data sets will be written. These take the name PDUMP.nnn and reside in the 
root directory of the drive specified. The name and directory cannot be 
overridden by the user. 


Note: See the Process Dump Formatter section of the Dump Formatter User 
Guide for information on formatting process dumps. 


1.3 REIPL 


The REIPL command allows the user to automate the re-booting (re-IPLing) of 
the system following an IPE. 


Syntax 


REIPL=ON | OFF 


Parameters 


ON 
This specifies the system to be automatically re-booted following an IPE. 


OFF 
This specified that the system is not to be automatically re-booted following 
an IPE. The system will remain hung until manually restarted. 


Notes: REIPL only applied to pre-WARP systems if APAR PJ12258 has been 
applied. 


REIPL has no effect when TRAPDUMP=ON|RO is specified. Whether the 
system is re-booted following a stand-alone dump is governed by the 
OS2DUMP module. If the the dump is to hard-disk then automatic re-boot 
occurs, otherwise not. 


1.4 SHAPIEXCEPTIONHANDLER 
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This command disables or enables the registration of the exception handler in 
the PMSHAPI.DLL module. 


Syntax 


SET SHAPIEXCEPTIONHANDLER=ON | OFF 


Parameters 


ON 
Thi 


s is the default setting. The shell AP! DLL exception handler is enabled 


and normal error recovery takes place whenever a user PM application or 
the desktop traps. 


OFF 


The shell API DLL exception handler is disabled. No additional error 
recovery provided by the shell takes place when a user application or the 
desktop traps. 


Notes: 


Exception handler registration only occurs during PMSHAPI.DLL 
initialization. Therefore, a change to the specification of 
SHAPIEXCEPTIONHANDLER will require the system to be re-booted. 


The shell AP! DLL exception handler will attempt to clean up an 
application’s PM resources. 


Under certain circumstances application traps can be pervasive. Either 
the default error recovery is too efficient to allow the trap to be 
intercepted or analyzed, or the trap recurses to a more serious problem, 
from which it is also difficult to determine the underlying cause. 
SHAPIEXCEPTIONHANDLER may be used under these circumstances to 
allow the problem to be intercepted closer to the point of occurrence. 


SHAPIEXCEPTIONHANDLER may be used with TRAPDUMP to force a 
system dump at the point of failure. 


Hangs in the shell during initialization may be the result of a recursive 


trap. SHAPIEXCEPTIONHANDLER may be used to intercept this condition. 


Since it is difficult to determine whether a potential shell problem involves 


PMSHELL.EXE or PMSHAPI.DLL, it is recommended to use 
SHAPIEXCEPTIONHANDLER with SHELLEXCEPTIONHANDLER. 


1.5 SHELLEXCEPTIONHANDLER 


This command disables or enables the registration of the exception handler in 


the PM 


Syntax 


SHELL.EXE module. 


SET SHELLEXCEPTIONHANDLER=ON | OFF 


Parameters 


ON 
Thi 


s is the default setting. The shell’s exception handler is enabled and 


normal error recovery takes place whenever a user PM application or the 
desktop traps. 


OFF 


The shell’s exception handler is disabled. No additional error recovery 
provided by the shell takes place when a user application or the desktop 
traps. 
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Notes: Exception handler registration only occurs during PMSHELL.EXE 
initialization. Therefore, a change to the specification of 
SHELLEXCEPTIONHANDLER will require the system to be re-booted. 


The shell’s exception handler will attempt to clean up an application’s PM 
resources. In addition if the application is the desktop (or whatever is 
specified in RUNWORKPLACE), then it is restarted. 


Under certain circumstances application traps can be pervasive. Either 
the default error recovery is too efficient to allow the trap to be 
intercepted or analyzed, or the trap recurses to a more serious problem, 
from which it is also difficult to determine the underlying cause. 
SHELLEXCEPTIONHANDLER may be used under these circumstances to 
allow the problem to be intercepted closer to the point of occurrence. 


SHELLEXCEPTIONHANDLER may be used with TRAPDUMP to force a 
system dump at the point of failure. 


Hangs in the shell during initialization may be the result of a recursive 
trap. SHELLEXCEPTIONHANDLER may be used to intercept this condition. 


Since it if difficult to determine whether a potential shell problem involves 
PMSHELL.EXE or PMSHAPI.DLL, it is recommended to use 
SHELLEXCEPTIONHANDLER with SHAPIEXCEPTIONHANDLER. 


1.6 SUPPRESSPOPUPS 


This command allows the user to suppress the display of trap information pop-up 
messages and instead, direct trap information to a log data set. 


Syntax 


SUPPRESSPOPUPS=x 


Parameters 


x This specifies the drive letter (excluding the colon) to which the pop-up log 
data set will be written. The log takes the name POPUPLOG.OS2 and 
resides in the root directory of the drive specified. The name and directory 
cannot be overridden by the user. 


1.7 TRACE 


TRACE specifies whether tracing of static trace events is to be active from 
system initialization or not. See the OS/2 Command Reference, TRACE 
command for details. Also see the System Trace User Guide in Volume 3 of The 
OS/2 Debugging Library. 


4 os/2 Debugging 


1.8 TRACEBUF 


TRACEBUF specifies the size of the system trace buffer. See the OS/2 Command 
Reference, TRACEBUF command for details. 


1.9 TRACEFMT 


The TRACEFMT utility is used to extract and format the system trace from the 
either a saved trace buffer or the currently active trace buffer. See the OS/2 
Command Reference, TRACEFMT command for details. 


1.10 TRAPDUMP 


Potential Data Loss 


Misuse of this facility may cause loss of vital data. Please read carefully the 


complete description before use. 


The TRAPDUMP command controls the stand-alone (system) dump facility of 
OS/2. It will enable initiation of a stand-alone dump at the instant a ring 3 trap 
occurs for which no exception handler has intervened. 


Ring 0 traps may be also intercepted only on 2.11 systems to which APAR 
PJ12258 has been applied, or on OS/2 Warp. 


Pre-Warp considerations: 

The dump process is performed by the hidden module OS2DUMP, which resides 
in the root directory of the boot drive. OS2DUMP as supplied with GA versions 
of OS/2 2.x dumps only to diskette. It may be replaced with a version supplied 
with OS/2 Problem Determination Package (OS2PDP) which will dump to a hard 
disk FAT partition that has the volume label SADUMP or to diskette, depending 
upon TRAPDUMP command specification. 


The GA 2.x version of OS2DUMP requires the first dump diskette be freshly 
prepared using the CREATEDD command and subsequent diskettes to be formatted. 
See the on-line OS/2 Command Reference for details of CREATEDD command. 


The OS/2 Problem Determination Package (OS2PDP) version of OS2DUMP only 
requires formatted diskettes, the use of CREATEDD being redundant. 


When dumping to hard disk the dump partition must to be made known to 
TRAPDUMP. This is done by specifying an optional second parameter. 


OS/2 Warp considerations: 
Under OS/2 Warp the CREATEDD command is unnecessary and is not distributed 
with the system. Ordinarily formatted diskettes may be used. Furthermore the 


enhanced version of OS2DUMP which allows dumping to a hard-disk FAT 
partition is standard. The partition volume label must be SADUMP. 


Syntax 


TRAPDUMP=[ON|OFF|RO] [,]X: 
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Parameters 


ON 


Specifies that the stand-alone dump process will be automatically initiated 
whenever an unrecoverable ring 3 trap occurs. For 2.11 systems with APAR 
PJ12258 or OS/2 Warp, any system IPE (including ring 0 traps) will also 
initiate a dump when ON is specified. 


OFF 


RO 


x: 


Specifies that the stand-alone dump process will not initiate automatically 
when an unrecoverable trap occurs. This is the default option. It does not 
prohibit the use of the Ctrl-Alt-Numlock-Numlock key sequence or the use of 
DosForceSystemDump to force a stand-alone dump to be initiated. 


Specifies that only ring zero traps and IPEs will automatically initiate the 
stand-alone dump process. This option applies only to 2.11 systems with 
APAR PJ12258 or OS/2 Warp. 


Note: When an IPE occurs the dump is taken immediately on displaying the 
IPE trap screen. For the purposes of dump analysis the formatted 
registers from the IPE screen should be located from the video buffer, 
which may be viewed using the analyze option from the PMDF. 


specifies the hard-disk FAT partition to which OS2DUMP will write a 
stand-alone dump. The partition letter must have the colon suffix. 


Note: The partition may be specified with either ON or OFF. When specified 


with OFF it will allow a stand-alone dump initiated by 
Ctrl-Alt-Numlock-Numlock to be written to the dump partition. 


Mountable media other than diskette drives are not detectable by 
OS2DUMP. The letter specifying the dump partition must be calculated as 
if any such media were not present. 


Only hard disk logical drives and primary partitions may be specified. 


When dumping to a hard disk partition is selected the system is 
automatically re-booted on completion of the dump. 


-— Attention —-—HAYNU_a4_,mHHo Ho 


The stand-alone dump process will erase all data on the dump media (disk 
partition or diskettes) before writing the dump. 


Do not specify a disk partition or use diskettes that contain vital data. 


Chapter 2. OS/2 RAS Application Programming Interfaces 


This chapter describes the subset of OS/2 RAS APIs for use by application 
programmers, which are not described in the OS/2 Technical Library, Control 
Programming Reference. 


Caution 


Some RAS programming interfaces may be specific to a particular release of 
OS/2 or have a release specific function. 


The APIs discussed in this section are: 


2.1, “DosSysTrace (Static Trace Event Recording).” 
2.2, “‘DosGetSTDA (Get the System Trace Data Area)” on page 10. 


2.3, “DosForceSystemDump (Force a System Stand-Alone Dump)” on 
page 14. 


2.4, “DosDumpProcess (Enable/Disable ProcessDump)” on page 15. 


2.5, “DosSuppressPopUps (Suppress Trap Exception Pop-Up Messages)” on 
page 16. 


2.6, “DosQueryRASInfo (Query RAS Information)” on page 17. 
2.7, “16-Bit Error Logging APIs for IBM OS/2 Version 2.1” on page 18. 
2.7.2, “DosLogRegister” on page 19. 
2.7.3, “DosLogEntry” on page 21. 
2.7.4, “DosLogRead” on page 23. 
2.8, “32-Bit Error Logging APIs for IBM OS/2 Version 2.1 and 3.0” on page 26. 
2.8.1, “LogOpen” on page 27. 
2.8.2, “LogClose” on page 28. 
2.8.3, “LogAddEntries” on page 28. 
2.8.4, “LogGetEntries” on page 32. 


2.1 DosSysTrace (Static Trace Event Recording) 


Static trace recording is available as both an API and a DevHlp routine. 


2.1.1 DosSysTrace (Add a Trace Record to the System Trace Buffer) 
DosSysTrace allows a subsystem or system extension to add information to the 
system trace buffer. 


Note: DosSysTrace is a 16-bit API. 


Coding Examples 
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EXTRN DosSysTrace:FAR 


PUSH WORD MajorCode ; major trace event code (240-255) 
PUSH WORD Length ; length of the variable length 
3; area to be recorded (0-512) 
PUSH WORD MinorCode 3; minor trace event code (0-255) 
PUSH@ OTHER Data ; pointer to the area to be traced 
; (address parameter) 
CALL DOSSYSTRACE 


16-bit MASM Example 


APIRET16 APIENTRY16 DosSysTrace(USHORT MajorCode, USHORT Length, 
USHORT MinorCode, PCHAR pData); 


32-bit code Example using CSet/2 


Parameters 


MajorCode 
The major code to be placed in the trace buffer. Only the low order byte is 
used. The high order byte should be 0 for future compatibility reasons, but 
no error checking of the high order byte is performed. 


Length 
The length of the area pointed to by the address parameter. If a length 
greater than 512 is specified, only 512 bytes will be recorded. If a length of 0 
is specified, the address parameter will not be used; however, a dummy 
doubleword must be pushed on the stack so that all calls use the same stack 
space. 


MinorCode 
The minor code to be placed in the trace buffer. This code identifies the 
specific trace event. Only the low order byte is used. The high order byte 
should be 0 for future compatibility reasons, but no error checking of the 
high order byte is performed. 


pData 
The address of the variable length data area which contains additional 
information that the system trace function will add to the trace buffer. Ifa 
length of 0 is specified, the address will not be used, but a value must still be 
added to the stack. 


Results 


DosSysTrace returns the following values: 
0 NO_ERROR 


150 
ERROR_SYSTEM_TRACE (trace is disabled for that event) 


IF AX = 0 
Data traced 
ELSE 
AX = Error_System_Trace 
Data not traced 


Note: An example of when data would not be traced is if the major event code 
is not currently selected for tracing. 
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Remarks 


All trace records consist of a header and optional data. The header record is 
built by DosSysTrace and contains: 


« Major event code 

*« Minor event code 

« Process ID of caller 

* Timestamp when the time is different from the previous trace record 
* Flag field 

« Data field (optional) 


The optional data field contains the variable-length data as passed by the caller. 


The trace facility maintains an array of 32 bytes (256 bits), in which each bit 
represents a major event code. This array is updated each time the user 
enables or disables tracing of a major event. The trace facility checks this array 
each time it is called to ensure that the major event specified is currently 
enabled for tracing. The array is located in the Global Information Segment. 


A prototype definition for DosSysTrace may be found under 2.9, “RAS API 
Prototypes” on page 37. 


2.1.2 DevHip_SysRAS (Add a Trace Record to the System Trace Buffer) 


The DevHIp_ SysTrace function provides a service for device drivers to add 
information to the system trace buffer. 


Note: DevHlip_SysTrace is a 16-bit API. 


Coding Example 


MOV AX,MajorCode 3; major trace event code (240-255) 
MOV BX,Length ; length of data area (0-512 bytes) 
MOV. CX,MinorCode ; minor trace event code (0-255) 
LDS SI,pData ; pointer to trace data 

MOV DL,28H ; DevH]p_SysRAS function code 


CALL [Device Help] invoke device helper 


16-bit MASM Example 


Parameters 


MajorCode 
The major code to be placed in the trace buffer. Only the low order byte is 
used. The high order byte should be 0 for future compatibility reasons, but 
no error checking of the high order byte is performed. 


Length 
The length of the area pointed to by the address parameter. If a length 
greater than 512 is specified, only 512 bytes will be recorded. If a length of 0 
is specified, the address parameter will not be used; however, a dummy 
doubleword must be pushed on the stack so that all calls use the same stack 
space. 


MinorCode 
The minor code to be placed in the trace buffer. This code identifies the 
specific trace event. Only the low order byte is used. The high order byte 
should be 0 for future compatibility reasons, but no error checking of the 
high order byte is performed. 
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pData 
The address of the variable length data area which contains additional 
information that the system trace function will add to the trace buffer. Ifa 
length of 0 is specified, the address will not be used, but a value must still be 
added to the stack. 


Results 
If CF = 0 
Trace record placed in trace buffer 


Else 
Data not traced 


The possible errors are as follows: 


* Tracing suspended 

- Minor code not being traced 
« PiD not being traced 

¢« Trace overrun 


Remarks 


The trace facility maintains an array of 32 bytes (256 bits), in which each bit 
represents a major event code. This array is updated each time the user 
enables or disables tracing of a major event. The device driver must check this 
array before calling DevHlp_SysTrace to ensure that the major event specified is 
currently enabled for tracing. This array is located in the Global Information 
Segment. 


All registers are preserved. Interrupts are disabled while the trace data is saved 
and then re-enabled if they were initially enabled. 


2.2 DosGetSTDA (Get the System Trace Data Area) 
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The DosGetSTDA API is a 16-bit API that returns a copy of the system trace 
buffer (STDA). 


Syntax 


The following 16-bit C language function prototype can be used to call the 
DosGetSTDA API: 


// 16 bit compiler 
extern unsigned far pascal DosGetSTDA( SEL, SHORT, SHORT ); 


// 32 bit compiler 
APIRET16 APIENTRY16 DosGetSTDA( SEL, SHORT, SHORT ); 


Where: SEL is the selector to the private buffer 
SHORT is the offset to the private buffer 
SHORT is the size of the buffer 
(maximum value = 64KB) 
records 


Returns: 0 - indicates correct operation, buffer is now filled 
with copy of the system trace buffer 
ERROR_SYSTEM_TRACE - System trace is not enabled 


Linker Considerations 


In order to successfully resolve DosGetSTDA function calls in your program, the 
following lines must be added to the Linker Definition (DEF) file: 


IMPORTS 
DOSGETSTDA=DOSCALL1.119 


Remarks 


DosGetSTDA returns a buffer that contains a copy of the system trace buffer. 
The buffer is circular with a header record that contains pointers to the first and 
last data bytes and a pointer to the next byte that was available for writing (the 
buffer is a snapshot of the system trace buffer at the time that the API was 
called). A set of trace records follows the header. Each trace record contains a 
trace event trailer and optionally a timestamp and/or a data field. A timestamp 
record is optional and will only exist if bit 2 of the flag field in the Trace Event 
Trailer is set to OFF. 


The trace event data contains the information describing each individual trace 
event. The events traced may be from OS/2 system supplied or other user 
supplied trace points. In either case the data is dependent on each individual 
trace point. Descriptions of the data and formatting instructions for the OS/2 
system supplied trace points can be found in the OS/2 Debugging Library, 
Volume 3 - System Trace Points Reference. 


2.2.1 Trace Buffer Structures 


Note: From the OS/2 2.11 FixPak 91 and OS/2 3.0 FixPak 8 the format of the 
STDA has changed to allow more meaningful timestamp information. See 
2.2.1.1, “New STDA Format” on page 14 at the end of this section for 


details. 
Pointer to Pointer to Pointer to 
First uy Next (#3) Last (#2) 
Entry #3 Entry #10 
I oe tbe sh, a 1 Se ET sy a ds 4 ae | 
jsystRACE| | | |.J | | [| [ol [..-f J J | | [at [ee | 
L CES es Sra Pe ra) Ce a OS (| ee (eS es J 
> > Pp > rPree F- PF > rere Fr FF PY 
Pointer 1—! | | A AY Ths he it all | | | | | | “Major Code 
Roincense ss a ee te | | | | | ‘— Length 
Pointer 3 ————! Welt a= MN Hs ih | | | | U-—— Minor Code 
i ABT deg ey <a | | | “——— Process ID 
Timestamp — | | | | | | | U——— Flags 
Flags —_ | | | | | | Timestamp 
Process ID ———_ |_| _ | Data (2 bytes) 
Minor Code —————__ | 
Length —_——_————_ | 
Major Code ! 


Figure 1. Circular Trace Buffer (STDA) 
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Name 


Table 1. Field Descriptions: Trace Control Record 


Description 


ID of Data Area 


Contains ASCII “SYSTRACE’ 


Pointer 1 


Offset of last byte of the trace buffer 


Pointer 3 


Offset of first byte of the trace buffer 


Offset of next available byte in the trace buffer 


Table 2. Field Descriptions: Trace Event Trailer Record (with Timestamp) 


Name 


#Bytes Description 


Timestamp 


(Conditionalimestamp in seconds and hundredths of 

on bit seconds (Conditional on bit 2 in the Flags byte) 
1in 
the 
flags 
byte) 


Minor Code 


1 Trace record flag 


Bit 0: 0 indicates an internal kernel generated 
trace record. 


Bit 1: 0 indicates that a timestamp is present. 


Bit 2: 1 signifies that the trace record was 
generated in protect mode. 


Bit 3: 0 signifies a static trace record, 1 a 
dynamic trace record. 


Bit 4: 1 indicates an incomplete dynamic trace 
record. 


Bit 5 - 7: reserved. 
ID of the process calling the API being traced 


Minor Event Code 


Length 


Length of data for the traced API 


Major Code 
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Major Event Code 


Remarks 


The buffer returned by DosGetSTDA is a simple circular buffer that is a snapshot 
of the OS/2 System Trace buffer at the time that the API was called. The actual 
System Trace buffer is emptied by the call. The buffer contains a header record 
that has pointers to the First, Last and Next bytes in the buffer. The offsets of the 
First and Last bytes are constant and the offset to next is used to indicate the 
last (most recent) trace record in the buffer. This pointer is logically moved 
backwards as the buffer is traversed. Since it is possible for a trace record to 
wrap back to the end of the buffer, it is necessary to look at each part of the data 
individually (trailer, timestamp and data) to determine whether the length of the 
data is greater than the distance between Next and First. If the length is greater, 
then the data is continued at the offset to Last. 


For example (see figure below), the buffer has been traversed until the pointer to 
Next is at byte 26. The event trailer record is 8 bytes and the distance from Next 
to First is 12, so the trailer is in contiguous memory. The pointer to Next is then 


set to byte 18. There is a timestamp which is two bytes. Our distance to First is 
now 4 so the timestamp is contiguous and the pointer to Next is reset to 16. This 
record has 4 bytes of data attached to it. The distance to First at this point is 2, 
so the data is wrapped: 2 bytes are adjacent to the Next, and the other 2 bytes 
begin at the pointer to Last. 


First (Byte 14) Next (byte 26) Last 


I T | | ] ] 
| TRACE HEADER| |T |EVENT TRAILER |T |EVENT TRAILER | (other trace | 
| (14 BYTES) |DATA| S|DATA LENGTH: 4] S|DATA LENGTH: O| records) |DATA 
L | ft] ee | | | 


Figure 2. Buffer Returned by DosGetSTDA 


The end of data in the trace buffer is indicated by a trace event trailer that 
contains a major code field of zero and a length field of zero. 


The display format of the OS/2 system supplied tracepoint data is described in 
the OS/2 Debugging Library, Volume 3 - System Trace Points Reference. Note 
that for data using the %S (ASCIIZ string) format type, the first byte of the data is 
reserved, bytes two and three contain the actual length of the string and the 
string begins at byte 4. 


TRACEFMT Unformatted Trace Buffer 


The trace formatter (TRACEFMT) is able to save the unformatted STDA buffer for 
formatting at a later date. The format of this buffer is as follows: 


File Header 


ak kok aoe i ns 
IS Y S TRAC E|STA|END|NXT| TRACE RECORDS ..... 
bobs Pa Tl a aT] 


la 22 24 26 28 


Figure 3. Unformatted Trace Buffer 


Remarks 


STDA LN 
ULONG length of the STDA read by DosGetSTDA. Length is 1 greater than 
the STDA end offset. 
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DATETIME 
A DATETIME structure returned by DosGetDateTime when this file buffer is 
created. 


CHECK KEY 
The DATETIME filed exclusively ORed with the string constant 
”“TRCFMTBUFF$”. 


STDA 
The STDA returned by DosGetSTDA. 


Note: DosGetSTDA resets the internal start, end and next offsets after the STDA 
has been read. This allows trace formatting programs to detect an empty 
buffer. 


For GA OS/2 2.x and OS/2 3.x the default start offset is 0x000e. 


After FixPak 91 (OS/2 2.11) and FixPak 8 (OS/2 3.) the default start offset is 
Ox001e. 


2.2.1.1 New STDA Format 

From FixPak 8 (OS/2 3.0) and FixPak 91 (OS/2 2.11) the system trace was 
enhanced to provide improved timestamp information. Each trace records is 
timestamped in hours, minutes, seconds and 1/100 seconds. The trace logging 
start and stop times are also logged and displayed by the TRACEFMT command. 


The spare bytes between the end of the STDA header and first trace record have 
been reserved for storing trace start and stop times. These are of the following 
format: 


~< 
a 
ae 
=a 
ra 
Lx | 


T 
C|TRACE RECORDS .... 
| 


28 30 38 


Figure 4. STDA Spare Bytes 


Where: 


yymdhnsc is the TRACE ON date and time in years, month day, hours, 
seconds and 100th seconds. 


YYMDHNSC is the TRACE OFF date and time in years, month day, hours, 
seconds and 100th seconds. 


2.3 DosForceSystemDump (Force a System Stand-Alone Dump) 


DosForceSystemDump allows an application to initiate a stand-alone system 
dump. 


Syntax 


APIRET APIENTRY DosForceSystemDump(ULONG reserved) ; 
32-bit code Example using CSet/2 


Parameters 
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reserved 
Reserved doubleword field that is set to OL. 


Returns 
There is no return from this API. 
Remarks 


The system is halted abruptly and a stand-alone dump is initiated. After the 
stand-alone dump process has completed the system must be re-booted. 


No shut down activity is performed when this API is called. File system buffers 
are not written to disk, cache is not flushed and files are not closed, data loss 
may result. 


DosForceSystemDump is equivalent to using the Ctrl-Alt-Numlock-Numlock key 
sequence. 


C Language prototype definitions for the DosForceSystemDump API may be 
found under 2.9, “RAS API Prototypes” on page 37. 


To format a system dump, see the OS/2 Debugging Library, Volume 2. 


For related information see: 
*- 1.10, “TRAPDUMP’” on page 5. 
* CREATEDD command in the OS/2 Command Reference. 


2.4 DosDumpProcess (Enable/Disable ProcessDump) 
DosDumpProcess allows an application: 
* To enable or disable dynamically the process dump facility. 
* To force a process dump for a given process. 


The default setting is for process dump to be disabled unless overridden by the 
DUMPPROCESS CONFIG.SYS command in 1.6, “SUPPRESSPOPUPS” on page 4. 


Syntax 


APIRET APIENTRY DosDumpProcess(ULONG Flag, ULONG Drive, PID pid); 
32-bit code Example using CSet/2 


Parameters 


Flag 
Doubleword field that may take one of the following values: 


* (DDP_DISABLEPROCDUMP 0x00000000L) 
Disable process dumps. 
« (DDP_ENABLEPROCDUMP 0x00000001L) 


Enable process dumps to be taken to a file in the root directory of a drive 
specified by the Drive parameter. 


* (DDP_PERFORMPROCDUMP 0x00000002L) 
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Drive 
Doubleword containing the ASCII value of the drive letter to which the 
PDUMP.nnn dump files will be written when DDP_ENABLEPROCDUMP is 
specified. For DDP_DISABLEPROCDUMP this parameter is ignored. 

pid 
Doubleword containing the process Id of the process to be dumped. 


This option is valid only with DDP_PERFORMPROCDUMP. If zero is specified 
for PiD then the current process is dumped. 


Returns. 
Return Code 


DosDumpProcess returns the following values: 
0 NO _ERROR 
87 ERROR_INVALID_PARAMETER 


303 
ERROR_INVALID_PROCID 


Remarks 


When process dump is enabled a dump file is written whenever a ring 3 process 
traps. The file takes the name PDUMP.nnn where nnn is incremented 
sequentially (staring from 000) for each successive dump. 


The directory to which PDUMP.nnn will be written is always the root directory of 
Drive. 


C Language prototype definitions for the DosDumpProcess may be found in 2.9, 
“RAS API Prototypes” on page 37. 


The content of a process dump comprise register information at time of trap, 
system control blocks (TCB, TSD, PTDA, MTE, SMTE, OTE, VMAR, VMOB and 
LTD) that describe the state of the process at the time of error, ring 0 and ring 3 
stack data for the trapping process. 


See the process Dump Formatter section of the Dump Formatter User Guide for 
information on formatting Process Dumps. 


Note: DDP_PERFORMPROCDUMP is not available in some early releases of 
OS/2 V2.11. 


2.5 DosSuppressPopUps (Suppress Trap Exception Pop-Up Messages) 
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DosSuppressPopUps allows an application to enable or disable dynamically trap 
exception pop-up suppression and to specify the drive where the pop-up 
suppression log will be recorded. 


The default setting is for disabled pop-up suppression unless overridden by the 
SUPPRESSPOPUPS CONFIG.SYS command in 1.6, “SUPPRESSPOPUPS” on 
page 4. 


Syntax 


APIRET APIENTRY DosSuppressPopUps(ULONG Flag, ULONG Drive); 
32-bit code Example using CSet/2 


Parameters 


Flag 
Doubleword field that may take one of the following values: 


* (SPU_DISABLESUPPRESSION 0x00000000L) 
Disable pop-up suppression. 
* (SPU_ENABLESUPPRESSION 0x00000001L) 


Enable pop-up suppression and pop-up logging to file POPUPLOG.OS2 on 
the drive specified by the Drive parameter. 


Drive 
Doubleword containing the ASCII value of the drive letter to which the 
POPUPLOG.OS2 log file will be written when SPU_LENABLESUPPRESSION is 
specified. With SPU_DISABLESUPPRESSION, Drive is ignored. 


Returns 
Return Code. 


DosSuppressPopups returns the following values: 
0 NO_ERROR 
87 ERROR_INVALID_ PARAMETER 


Remarks 


The directory to which POPUPLOG.OS2 will be written is always the root 
directory of Drive. 


A prototype definition of DosSuppressPopUps may be found in 2.9, “RAS API 
Prototypes” on page 37. 


See also the DosError API in the OS/2 Control Program Programming Reference. 


2.6 DosQueryRASInfo (Query RAS Information) 


DosQueryRASInfo returns information about active trace event recording and 
System Logging facility from the Global Information segment (InfoSegGDT) dump. 


Syntax 


APIRET APIENTRY DosQueryRASInfo(ULONG Index, PPVOID Addr); 
32-bit code Example using CSet/2 


Parameters 


Index 
Doubleword field that may take one of the following values: 


* (SPU_SIS_MEC_TABLE 0x00000001L) 


Chapter 2. OS/2 RAS Application Programming Interfaces 17 


Return the address of the table of actively traced major event codes in 
the InfoSegGDT. The table is 32 bytes long and each bit represents each 


major event code from 0 to 255. 


* (SIS_SYS_LOG 0x00000002L) 


Return the address of the SYSLOG status word from InfoSegGDT. The 


status may contain a combination of: 


— (LF_LOGENABLE 0x0001) Logging enabled 


— (LF_LOGAVAILABLE 0x0002) Logging available 


Returns 

Return Code. 

DosQueryRASInfo returns the following values: 
0 NO ERROR 

5 ERROR_ACCESS DENIED 

87 ERROR_INVALID_ PARAMETER 


Remarks 


For related information see: 
¢ Logging facility 
* The OS/2 Trace facility 


2.7 16-Bit Error Logging APIs for IBM OS/2 Version 2.1 
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This section describes the “Logging Facility for OS/2 2.1”. 


This comprises a set 


of three APls, the logging deamon (LOG.SYS) and the log formatter (SYSLOG). 


Both the Logging Deamon and Log Formatter are described in the OS/2 
Command Reference Manual (see LOG.SYS under DEVICE statement of 


CONFIG.SYS and the SYSLOG command. 


Note: C Language prototype definitions for the error logging APIs may be found 


under 2.9, “RAS API Prototypes” on page 37. 


The following topics are described in this section: 


¢ 2.7.1, “Dynamic vs. Static Error Log Record ID Registration” on page 19. 


- 2.7.2, “DosLogRegister” on page 19. 
* 2.7.3, “DosLogEntry” on page 21. 
* 2.7.4, “DosLogRead” on page 23. 


* 2.7.5, “Error Log Entry Formatting DLL Routines” on page 24. 


2.7.1_ Dynamic vs. Static Error Log Record ID Registration 


OS/2 2.0 users of the DosLogEntry API will not need to use the DosLogRegister 
API. The DosLogRegister API is only maintained on OS/2 2.0 to support existing 
OS/2 1.3 programs that did need to use the API. 


The OS/2 2.0 Version of the DosLogRegister API will always return a default 
Error Log record ID. It will accept a format template string as an input, but it will 
do nothing with the string since format template strings will not be saved within 
the OS/2 2.0 Version of the Error Log file. 


The OS/2 2.0 Version of the DosLogEntry API will behave similarly to the OS/2 
1.3 Version of the API. Since the OS/2 2.0 Version of the system Error Logging 
facility no longer supports the saving of format template strings within the Error 
Log file, it is necessary to provide a method by which DosLogEntry callers can 
associate their Error Log entry with a formatting (.DLL) routine. The OS/2 2.0 
Version of the DosLogEntry API will make a special interpretation of the 
Originator Name field within the packet header. It will be assumed that this 
name field (if not NULL) contains the name of a Error Log formatting .DLL 
module. 


2.7.2 DosLogRegister 
There are two major differences between the OS/2 2.0 Version of 
DosLogRegister and the 1.3 version of the API: 


« DosLogRegister no longer supports dynamic registration of Error Log record 
IDs. Instead, the API always returns a single default value. 


- DosLogRegister no longer supports entry format template registration. While 
the API still accepts a format template as part of its input data packet, the 
format template will not be acted upon in any way. 


DosLogRegister continues to support the existing alert notification registration 
function. 


The description of the OS/2 2.0 Version of the DosLogRegister API follows: 


Syntax 
APIRET16 APIENTRY16 DosLogRegister((PUSHORT) LogHandle, 
(PVOID) LogRegList, 
(PUSHORT) RequestID) 
32-bit code Example using CSet/2 
Parameters 
LogHandle 


The address of the word in which the system will return the handle of a 
named pipe that will be transparently used in subsequent DosLogRead calls. 


LogRegList 
The address of the log registry buffer. 


RequestID 
The address of the word that the system will fill in with a default Error Log 
record ID (if the “Error Log record ID’ field in the log registry buffer is set by 
the caller to -1) 
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Returns 
Return code 


DosLogRegister returns the following values: 
0 Success 


non-zero 
Failure 


Possible reasons for failure are: 
Facility unavailable 
Record ID in use 
Registration failed (general failure) 
Invalid ID 
Too many open files 
Too many semaphores 
Semaphore not found 
User semaphore limit reached 
Request timed out without satisfaction 


Error Log buffer temporarily full 


Remarks 


I 
[Length of the registration data 2 


|Reserved 2 


Po 


[Error Log record ID 


Offset to the format template layout field 2 


|Semaphore name string variable length| 


|Format template layout variable length| 
I | 


Figure 5. Log Registry Buffer Format Description 


Where: 


Length of the registration data 
Is the total number of bytes in the current Log Registry Buffer (this length 
includes the two byte length field itself) 


Reserved 
Is a two byte reserved field 


20 os/2 Debugging 


Error Log record ID 
Contains the Error Log record ID that caller wishes to be registered for. If 
the field is set to OxFFFF (-1), then a “default” record ID is returned in the 
word pointed to by the “RequestID’ parameter. This field can be used to 
specify an alert notification record ID (that is, the caller wishes to be alerted 
whenever an Error Log Entry containing this record ID is logged). 


Offset to the format template layout field 
Is the offset within the Log Registry Buffer to the start of the format template 
layout area. 


Semaphore name string 
Is the name of a system semaphore, created with the nonexclusive option, 
that will be used to alert the caller’s process when an Error Log entry 
containing the specified “Error Log record ID’ is logged. The name string is 
an ASCIIZ string. 


Format template layout 
Is an area within the Log Registry Buffer that contains the formatting 
structure information that is placed within the 1.3 Error Log file. This area is 
not used in the OS/2 2.0 Version of the DosLogRegister call. However, the 
‘length of the registration data’ field should reflect the size of this area. 


In order to successfully resolve DosLogRegister function calls in your program, 
the following lines must be added to the Linker Definition (DEF) file: 


IMPORTS 
DOSLOGREGISTER=DOSCALL1.195 


2.7.3 DosLogEntry 


There are two major differences between the OS/2 2.0 Version of DosLogEntry 
and the 1.3 Version of the API: 


* Since the DosLogRegister API will only return a “default” Error Log record ID 
to its caller, the DosLogEntry caller must override this “default” record with 
the appropriately statically allocated record ID if the caller wishes to see the 
“correct” record ID in the Error Log record. 


* Since there is no explicit “Error Log record formatting DLL module name” 
field in the DosLogEntry log data packet, the API will attempt to interpret the 
‘Originator Name’ field in the packet’s header portion as a formatting DLL 
module name. 


The description of the OS/2 2.0 Version of the DosLogEntry API is as follows: 


Syntax 
APIRET16 APIENTRY16 DosLogEntry((USHORT) Function, 
(PVOID) LogData) 
32-bit code Example using CSet/2 
Parameters 
Function 


This specifies the type of log entry as follows: 


0H Reserved 
1H Error Logging 
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2H-FFFFH Reserved 


LogData 
This is the address of the log data buffer that contains one or more variable 
length log packets. 


Returns 
Return Code 


DosLogEntry returns the following values: 
0 Success 


non-zero 
Failure 


Possible reasons for failure: 
Invalid function 
Facility unavailable 
Facility suspended 


Error Log buffer temporarily full 
Remarks 


Error Log Data Buffer format description: 


Multiple log packets can be included within a single log data buffer. In the 
following diagram, the size of each field is indicated in bytes: 


I 
|# of log packets (within the buffer) 2 


| 

| 
[length of the current log packet 2|<— 

| 
[Error Log record ID 2| | 
| | 
|Time of logging 4| | multiple 

| | log packets 
[Date of logging 4| | within a 

| | single log 
|Originator name 8| | data buffer 
i) il 
[Qualifier name 4| | 
| | 

J 


[Error Log entry data <= 1024|< 
I 


Figure 6. Error Log Data Buffer Format Description 


Where: 


# of log packets 
Is the number of separate packets contained within the user’s buffer 
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Length of the current log packet 
Is the number of bytes in the current log packet within the user’s log data 
buffer (this length includes the length of all the log packet control fields and 
the size of the Error Log entry data). 


Error Log record ID 
Is the record ID for the current Error Log entry (ID registration will be 
statically registered by the OS/2 development organization). The caller may 
pass in the “default” Error Log record ID that is returned by the 
DosLogRegister API. 


Time of logging 
Is filled in by the system Error Logging facility ) 


Date of logging 
Is filled in by the system Error Logging facility 


Originator name 
Is a primary name field that is provided by the caller 


Qualifier name 
is a secondary name field that is provided by the caller 


Error Log entry data 
Is an optional variable length set of data that can be supplied by the caller 
(the format of the data is under the control of the caller). 


In order to successfully resolve DosLogEntry function calls in your program, the 
following lines must be added to the Linker Definition (DEF) file: 


IMPORTS 
DOSLOGENTRY=DOSCALL1.193 


2.7.4 DosLogRead 
The description of the OS/2 2.0 Version of the DosLogRead API follows: 


APIRET16 APIENTRY16 DosLogRead((USHORT) LogHandle, 
(USHORT) Length, 
(PVOID) LogBuffer, 
(PUSHORT) ReadSize) 
32-bit code Example using CSet/2 


Parameters 


LogHandle 
This is the named pipe handle returned by DosLogRegister() 


Length 
This is the length (in words) of the caller’s log buffer 


LogBuffer 
This is the address of the caller’s buffer, into which the system Error Logging 
facility will place a single Error Log entry packet (formatted in the manner of 
the 16-bit DosLogEntry API). 


ReadSize 
This is the address of a word, into which the system Error Logging facility 
will place the number of bytes that it wrote into the caller’s log buffer. Ifa 
zero is returned here, then there was no Error Log packet to return. 
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Returns 
Return code 


DosLogRead returns the following values: 
0 Indicating success. 


non-zero 
Indicating error 


Possible reasons for failure: 


Invalid log handle 
Facility unavailable 


Buffer too small 


In order to successfully resolve DosLogRead function calls in your program, the 
following lines must be added to the Linker Definition (DEF) file: 


IMPORTS 
DOSLOGREAD=DOSCALL1.196 


DosLogRead returns Error Log entries that are formatted in the manner of the 
16-bit DosLogEntry API. 


2.7.5 Error Log Entry Formatting DLL Routines 
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Each Error Log record within an Error Log file can contain the name of a 
formatting DLL module. A formatting DLL module is invoked by the SYSLOG 
utility when SYSLOG encounters an Error Log record that contains the name of 
the DLL module. 


Each formatting module contains a single formatting routine that can be 
identified by an ordinal value of 1. The formatting routine can be designed to 
handle a single type of Error Log entry or to handle multiple types of Error Log 
entries. When SYSLOG passes control to a formatting routine, it passes the 
entire Error Log record (both header portion and data portion) to the formatting 
routine. The formatting routine has the complete flexibility to format an Error 
Log entry as it deems appropriate. 


SYSLOG uses the DosLoadModule API to create a run-time link to the specified 
formatting DLL module. It uses the DosFreeModule API to free the DLL module 
after it receives its response from the formatting routine. 


There are no specific rules that govern the naming of a formatting DLL module. 
However, since it is desirable to reduce the possibility of colliding with another 
DLL module of the same name, it is suggested that a formatting DLL module be 
labelled with a name that adheres to the following standard form: 


ELGxxxxx.DLL (where ”xxxxx” corresponds to the Error 
Log record ID (in decimal) of any one 
of the types of records that the formatting 
routine is designed to handle) 


For example, 


”ELGO0127.DLL” is a standardized name for a formatting DDL 
module that recognizes (among other things) 
Log records with ID of 127 (decimal) 


This standard naming convention is suggested because it is assumed that the 
Error Log records of any one ID will only be recognized by a single formatting 
routine. Therefore the use of the ”xxxxx” suffix (based on record ID) should 
assure uniqueness for the formatting module name. 


The static Error Log record ID registration mechanism that is enforced by the 
OS/2 development organization will attempt to keep a list not only of the Error 
Log record IDs in use, but also the names of the formatting DLL modules that 
correspond to each record ID. This will also help to reduce the possibility of 

formatting DLL module names colliding. 


In addition to its single formatting routine, each formatting DLL module must 
contain a global variable named ”“ELOG_FORMAT”. For OS/2 2.0, this exported 
global variable must be set to a value of 1. When SYSLOG loads a prospective 
formatting DLL module it attempts to access this global variable and check 
whether it has the expected value of 1. If the global variable check fails, then 
SYSLOG can conclude that it has accidentally loaded another DLL module with 
the same name as the formatting module that is mentioned in the Error Log 
entry. This check is intended as a form of protective validation for SYSLOG. The 
variable will in future releases be used as a revision level for the 
SYSLOG/formatting DLL module interface specification. 


When a user constructs a Error Log entry formatting DLL module, care should be 
taken not to export the names of its constituent formatting routine (though the 
required ELOG_FORMAT global variable must be exported). Not exporting the 
module name will save storage space within the OS/2 kernel. The SYSLOG 
utility will be written to use the ordinal version of the DosGetProcAddr API. 


Error Log record formatting DLL routines must be written as 32-bit procedures. 
A typical Error Log record formatting DLL routine will have to accept the 
parameters: 


ULONG ELGxxxxx((PVOID) Log Record, (PVOID) String Buffer, 
(ULONG) Buffer_Length, (PULONG) String Length) 


Parameters 


Log_Record 
A linear pointer to an Error Log record that is being passed from SYSLOG to 
the formatting routine. The Error Log record adheres to the format that is 
described in the section that follows entitled “Error Log File Entry Format”, 
except that the linear pointer points to the “TOT_LENGTH’” field (since the 
”“PREV_PTR” and ”“PREV_SIZE” fields are of no interest to a formatting 
routine). 


String Buffer 
Is a linear pointer to a buffer provided by SYSLOG so that the formatting 
routine can return a series of ASCIIZ strings to SYSLOG. Each ASCIIZ string 
should correspond to a line of formatted display. Each ASCIIZ string should 
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be limited to a maximum of 80 characters. SYSLOG will paint each string 
“line” within its client window. The strings should not contain NEWLINE 
characters. SYSLOG will automatically format the header portion of the 
Error Log entry. The formatted output prepared by this routine will follow the 
formatted header display. 


Buffer_Length 
Is a 32-bit integer that contains the maximum size of the ’String_Buffer’. 


String_Length 
Is a pointer to a 32-bit integer that is set by the formatting routine to the total 
length of the ASCIIZ strings that have been placed in the ’String_Buffer’. 


Returns 


ELGxxxxx returns the following: 
0 Indicating success 


-1. Indicates insufficient space in the “String Buffer’, positive values indicate 
formatting routine errors. 


If a formatting DLL routine returns a positive error code to SYSLOG, SYSLOG 
will format the header portion of the Error Log record in the standard manner, 
display the returned formatting routine error code (as a line within the formatted 
display), and then format the data portion of the Error Log record as a 
hexadecimal dump. 


If an Error Log record fails to point to a formatting DLL module, or if the 
formatting DLL module cannot be successfully loaded and validated, then 
SYSLOG will format the header portion of the Error Log record in the standard 
manner, display a message that a formatting routine was not specified or could 
not be successfully invoked (as a line within the formatted display), and then 
format the data portion of the Error Log record as a hexadecimal dump. 


If there is insufficient space in the ’String_ Buffer’, then the formatting routine will 
return a -1 status code, and will place the required length of the formatted 
display string in the caller’s output length variable. SYSLOG can react to this 
error by recalling the formatting routine with a larger ‘String Buffer’. 


SYSLOG will contain logic to format the standard SNA Generic Alert entry (that 
is, Error Log record ID of 2). This is necessary since most of the existing Error 
Log calls are used to pass generic alerts (and the existing calls can not pass in 
formatting DLL routine names). This design choice does not prevent future Error 
Log callers to specify a record ID of 2 and also to pass in the name of a 
formatting DLL routine that knows how to specially format that Generic Alert 
entry. 


2.8 32-Bit Error Logging APIs for IBM OS/2 Version 2.1 and 3.0 
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This section describes the “Logging Facility for OS/2 2.1 and 3.0”. This 
comprises a set of four APIs, a DevHlp function, the logging deamon 
(LOGDAEM.EXE), the logging device driver (LOG.SYS) and the log formatter 
(SYSLOG). 


The Logging Deamon, Device Driver and Log Formatter are described in the 
OS/2 Command Reference - see LOG.SYS under the DEVICE statement of 
CONFIG.SYS and the SYSLOG command. 


Note: C Language prototype definitions for the Error Logging APIs may be found 
in 2.9, “RAS API Prototypes” on page 37. 


The following topics are described in this section: 
* 2.8.1, “LogOpen” 
* 2.8.2, “LogClose” on page 28 
* 2.8.3, “LogAddEntries” on page 28 
- 2.8.4, “LogGetEntries” on page 32 
* 2.8.5, “32-Bit Error Log Entry Formatting DLL Routines” on page 33 
* 2.8.6, “DevHlp_LogEntry Device Driver Interface” on page 36 
The set of four 32-bit logging APIs provide equivalent functionallity to the three 


16-bit logging APIs discussed in the previous section. They may be used as a 
complete replacement to the 16-bit set. 


2.8.1 LogOpen 
LogOpen is a 32-bit system Error Logging facility high level API. It is used to 


open a connection to the facility (through the System Logging Service device 
driver). 

The description of the LogOpen API call follows: 

Syntax 


APIRET APIENTRY LogOpen(PHFILE phf); 


Parameters 


phf 
This points to a file handle holder that on return will hold an open file handle 


Returns 
Return code 


LogOpen returns the following values: 
Q Success 


non-zero 
Facility not available 


Remarks 


The file handle that is returned by the LogOpen API is required in all subsequent 
high level system Error Logging facility API calls. 


In order to resolve successfully LogOpen function calls in your program, the 
following lines must be added to the Linker Definition (DEF) file: 
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IMPORTS 
LogOpen=DOSCALL1.430 


2.8.2 LogClose 


LogClose is a 32-bit system Error Logging facility high level API. It is used to 
close a connection to the facility. 


The description of the LogClose API call follows: 
Syntax 


APIRET APIENTRY LogClose(HFILE hf); 


Parameters 


hf Is the file handle returned by LogOpen() 
Returns 
Return code 


LogClose returns the following values: 
0 Success 


non-zero 
Failure, possible reason: facility not open 


Remarks 


In order to resolve successfully LogClose function calls in your program, the 
following lines must be added to the Linker Definition (DEF) file: 


IMPORTS 
LogC1lose=DOSCALL1.431 


2.8.3 LogAddEntries 


LogAddEntries is a 32-bit system Error Logging facility high level API. It is used 
to allow application processes to add Error Log entries to the internal Error Log 
buffer that is maintained by the System Logging Service device driver. 


The description of the LogAddEntries API call follows: 


Syntax 
APIRET APIENTRY LogAddEntries(HFILE hf, ULONG service, 
PVOID log data_address) ; 
Parameters 


hf Is the file handle returned by LogOpen() 


28 =«Oos/2 Debugging 


service 
Specifies the class of logging facility: 


0x0 Reserved 
0x1 Error Logging 
Ox2 - Oxffff Reserved 


log_data_address 
Is the address of a buffer that contains a variable length Error Log entry. 
The first word of the buffer contains the number of packets in the Error Log 
entry 


Returns 
Return code 


LogAddEntries return the following values: 
0 Success 


non-zero 
Failure 


Possible reasons for failure are: 
Invalid log type 
Facility unavailable 
Facility suspended 
Facility not open 


Error Log buffer temporarily full 


Remarks 


Error Log Entry Buffer format description: 


Multiple Error Log packets can be included within a single Error Log entry buffer. 


If multiple packets are included within a single buffer, each individual packet 


should be aligned on a double word boundary. In the following diagram, the size 


of each field is indicated in bytes: 
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| 
|Packet revision number 2 


| 

| 
|# of Error Log entry packets 2| 

| 
|Length of this Error Log entry packet 2|< 
i i 
[Error Log record ID 2| | 

i 
[Status flags 4; | 

a 
[Qualifier name 4| | multiple 
| i! Ol) SEReor: 
|Reserved 4| | Log entry 
| | | packets 
|Time of logging 4| | within a 

| | single 
[Date of logging 4| | Error Log 
| | | Entry Buffer 
{Originator name 8 or 256| | 
| 
[Process name (optional) 0 or 260| ‘| 

| 

[Formatting DLL module name (optional) 12| 
be Il 

| 

| 


[Error Log entry data <= 3400|<—_ 
I 


Figure 7. Error Log Entry Buffer Format Description 
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Where 


Packet revision number 
Is an integer value that can be used to distinguish error logging packets that 
are intended to be handled by different revisions of the LogAddEntries API. 
For the initial version of the API, this field should be set to a value of 1. This 
field is included in the packet to support future backward compatibility. 


# of Error Log entry packets 
Is the number of separate packets contained within the user’s buffer. 


Length of this Error Log entry packet 
Is the number of bytes in the current Error Log entry packet within the user’s 
Error Log Entry Buffer (this length includes the length of all the Error Log 
entry packet control fields and the size of the Error Log entry text). To 
support efficient logging execution, this length should be a multiple of 4 bytes 
(i.e. if necessary the user should pad the Error Log entry packet). 


Error Log record ID 
Is the record ID for the current Error Log entry (ID registration will be 
statically registered by the OS/2 development organization). 


Status flags 
Is a two byte flag holder that contains three single bit flags: 


(BIT 0) is used to indicate whether the current Error Log entry packet 
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contains space in which the Error Logging facility can place a long process 
name (“on” indicates YES, “off” indicates NO); 


(BIT 1) is used to indicate whether the current Error Log entry packet 
contains an 8 byte originator name or a 256 byte originator name (“on” 
indicates a 256 byte originator name, “off” indicates an 8 byte originator 
name); 


(BIT 2) is used to indicate that the caller has placed time and date values in 
the Error Log entry packet and does not wish to have those values modified 
during the logging process (”on” indicates that the Error Log entry packet 
already contains time and date values, “off” indicates the packet does not 
already contain time and date values); 


All the other 29 bits in “status flags’ are considered reserved at this time 
and will be zeroed by the LogAddEntries API. 


Qualifier name 
Is a secondary name field that is provided by the caller 


Reserved 
Is a four byte reserved field 


Time of logging 
Is filled in by the system Error Logging facility (unless BIT 2 of the ‘status 
flags field is “on”, indicating that the caller has preset a time value). 


Date of logging 
Is filled in by the system Error Logging facility (unless BIT 2 of the ‘status 
flags field is “on”, indicating that the caller has preset a date value); 


Originator name 
Is a primary name field that is provided by the caller. 


Process name 
Is an optional long process name field that will be filled in by the Error 
Logging facility if the field is provided by the caller in the Error Log entry 
packet. 


Formatting DLL module name 
Is the optional name of a DLL module that houses a formatting routine that 
recognizes this type of Error Log entry and can format it for display by the 
SYSLOG utility. The name is specified as an ASCIIZ string that can be up to 
eight characters in length. If no module name is specified in this field, then 
SYSLOG will display the data portion of the Error Log entry as a hexadecimal 
dump. 


Error Log entry data 
Is an optional variable length set of data that can be supplied by the caller 
(the format of the string is under the control of the caller). 


The format and function of the LogAddEntries API call is very similar to that of 
the 16-bit DosLogEntry call. There are several functional differences from the 
DosLogEntry call: 


* The user-supplied error log entry Record ID will now be a statically allocated 
value rather than a dynamically allocated value. 


* The maximum size of the originator name field in the caller’s packet has 
been increased from 8 bytes to 256 bytes. The caller can specify whether 


Chapter 2. OS/2 RAS Application Programming Interfaces 31 


the packet contains an 8 byte originator name field or a 256 byte originator 


name field. 


* The maximum size of the variable length data portion within the caller’s 
packet has been increased from 1024 bytes to 3400 bytes 


¢ The order of the fields within the Error Log entry has been slightly 
rearranged to support the creation of smaller internal control messages. 


In order to resolve successfully LogAddEntries function calls in your program, 
the following lines must be added to the Linker Definition (DEF) file: 


IMPORTS 


LogAddEntries=DOSCALL1. 432 


2.8.4 LogGetEntries 
LogGetEntries is a 32-bit system Error Logging facility high level API. It is used 
to allow application processes to obtain Error Log entries from the internal Error 
Log buffer that is maintained by the System Logging Service device driver. 
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LogGetEntries description: 


Syntax 


APIRET APIENTRY LogGetEntries(HFILE hf, ULONG service, 


Parameters 


ULONG type, PVOID buffer, 
ULONG buffer_length) ; 


hf is the file handle returned by LogOpen() 


service 


Specifies the class of logging facility: 


0x0 
Ox1 
Ox2 - Oxffff 


type 


Reserved 
Error Logging 


Reserved 


Specifies the class of internal logging buffer to read: 


0x0 
Ox1 
0x2 


0x3 - Oxffff 


buffer 


Reserved 
Buffer that contains all logged entries 


Buffer that only contains entries that were logged by device 
drivers 


Reserved 


Is a pointer to a buffer that will receive entries copied from the internal 
logging service buffer (if the caller’s buffer is too small to fit all the current 
entries in the device driver Error Log buffer, then on return the first double 
word of the buffer will be set to the size of the Error Log buffer, expressed as 
a number of bytes). 


buffer_length 
Thi is the length of the caller’s buffer. 


Returns 
Return Code 


LogGetEntries returns the following values: 
0 Success 


non-zero 
Failure 


Possible reasons for failure: 
Facility not open 
Facility unavailable 


Buffer too small 


Remarks 


The format and function of the LogGetEntries API call is very similar to that of 
the 16-bit DosLogGetBuffer call. 


In a similar fashion to the DosLogGetBuffer API, if the caller’s buffer is too small 
to fit all the current entries in the device driver Error Log buffer, an error return 
code is set indicating this problem, and no Error Log entries are placed in the 
caller’s buffer. In this case, the first doubleword of the buffer is set to the size of 
the Error Log buffer (expressed as a number of bytes). If this error occurs, the 
caller should repeat the LogGetEntries call with a larger buffer. 


In order to resolve successfully LogGetEntries function calls in your program, the 
following lines must be added to the Linker Definition (DEF) file: 


IMPORTS 
LogGetEntries=DOSCALL1. 433 


2.8.5 32-Bit Error Log Entry Formatting DLL Routines 


Each Error Log record within an Error Log file can contain the name of a 
formatting DLL module. A formatting DLL module is invoked by the SYSLOG 
utility when SYSLOG encounters an Error Log record that contains the name of 
the DLL module. 


Each formatting module contains a single formatting routine that can be 
identified by an ordinal value of 1. The formatting routine can be designed to 
handle a single type of Error Log entry or to handle multiple types of Error Log 
entries. When SYSLOG passes control to a formatting routine, it passes the 
entire Error Log record (both header portion and data portion) to the formatting 
routine. The formatting routine has the complete flexibility to format an Error 
Log entry as it deems appropriate. 


SYSLOG uses the DosLoadModule API to create a run-time link to the specified 


formatting DLL module. It also uses the DosFreeModule API to free the DLL 
module after it receives its response from the formatting routine. 


Chapter 2. OS/2 RAS Application Programming Interfaces 33 


34 


OS/2 Debugging 


There are no specific rules that govern the naming of a formatting DLL module. 
However, since it is desirable to reduce the possibility of colliding with another 
DLL module of the same name, it is suggested that a formatting DLL module be 
labeled with a name that adheres to the following standard form: 


ELGxxxxx.DLL (where ”xxxxx” corresponds to the Error 
Log record ID (in ecimal) of any one 
of the types of records that the formatting 
routine is designed to handle) 


For example, 


”ELGO0127.DLL” is a standardized name for a formatting 
DDL module that recognizes (among other things) Error 
Log records with ID of 127 (decimal) 


This standard naming convention is suggested because it is assumed that the 
Error Log records of any one ID will only be recognized by a single formatting 
routine. Therefore the use of the ”xxxxx” suffix (based on record ID) should 
assure uniqueness for the formatting module name. 


The static Error Log record ID registration mechanism that is enforced by the 
OS/2 RAS development group will attempt to keep a list not only of the Error Log 
record IDs in use, but also the names of the formatting DLL modules that 
correspond to each record ID. This may also help to reduce the possibility of 
formatting DLL module names colliding. 


In addition to its single formatting routine, each formatting DLL module must 
contain a global variable named “ELOG_FORMAT”. This exported global 
variable must be set to a value of 1. When SYSLOG loads a prospective 
formatting DLL module it will attempt to access this global variable and check 
whether it has the expected value of 1. If the global variable check fails, then 
SYSLOG can conclude that it has accidentally loaded another DLL module with 
the same name as the formatting module that is mentioned in the Error Log 
entry. This check is intended as a form of protective validation for SYSLOG. The 
variable may in future releases be used a sort of revision level for the 
SYSLOG/formatting DLL module interface specification. That is why it will 
initially be forced to a value of 1. 


When a user constructs a Error Log entry formatting DLL module, care should be 
taken not to export the names of its constituent formatting routine (though the 
required ELOG_FORMAT global variable must be exported). Not exporting the 
module name will save storage space within the OS/2 kernel. 


Error Log record formatting DLL routines must be written as 32-bit procedures. 
A typical Error Log record formatting DLL routine will have to accept the 
parameters: 


APIRET APIENTRY ELGxxxxx(PVOID Log Record, 
PVOID String Buffer, 
ULONG Buffer_Length, 
PULONG String Length) ; 


Parameters 


Log_Record 
Is a linear pointer to an Error Log record that is being passed from SYSLOG 
to the formatting routine. The Error Log record adheres to the format that is 
described in the section that follows entitled “Error Log File Entry Format”, 
except that the linear pointer points to the ”“TOT_LENGTH’” field (since the 
”“PREV_PTR” and ”“PREV_SIZE” fields are of no interest to a formatting 
routine). 


String Buffer 
Is a linear pointer to a buffer provided by SYSLOG so that the formatting 
routine can return a series of ASCIIZ strings to SYSLOG. Each ASCIIZ string 
should correspond to a line of formatted display. Each ASCIIZ string should 
be limited to a maximum of 80 characters. SYSLOG will paint each string 
“line” within its client window. The strings should not contain NEWLINE 
characters. SYSLOG will automatically format the header portion of the 
Error Log entry. The formatted output prepared by this routine will follow the 
formatted header display. 


Buffer_Length 
Is a 32-bit integer that contains the maximum size of the the ’String_Buffer’. 


String_Length 
Is a pointer to a 32-bit integer that is set by the formatting routine to the total 
length of the ASCIIZ strings that have been placed in ’String_ Buffer’. 


Returns 


ELGxxxxx returns the following: 
0 Indicating success. 


-1_ Indicates insufficient space in ‘String Buffer’ positive values indicate 
formatting routine errors. 


Remarks 


If a formatting DLL routine returns a positive error code to SYSLOG, SYSLOG 
will format the header portion of the Error Log record in the standard manner, 
display the returned formatting routine error code (as a line within the formatted 
display), and then format the data portion of the Error Log record as a 
hexadecimal dump. 


If an Error Log record fails to point to a formatting DLL module, or if the 
formatting DLL module cannot be successfully loaded and validated, then 
SYSLOG will format the header portion of the Error Log record in the standard 
manner, display a message that a formatting routine was not specified or could 
not be successfully invoked (as a line within the formatted display), and then 
format the data portion of the Error Log record as a hexadecimal dump. 


If there is insufficient space in the ‘String Buffer’, then the formatting routine will 
return a -1 status code, and will place the required length of the formatted 
display string in the caller’s output length variable. SYSLOG can react to this 
error by recalling the formatting routine with a larger ‘String Buffer’. 


SYSLOG contains logic to format the standard SNA Generic Alert entry (For 
example, Error Log record ID of 2). This is necessary since most of the existing 
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Error Log calls are used to pass generic alerts (and the existing calls can not 
pass in formatting DLL routine names). This design choice does not prevent 
future Error Log callers to specify a record ID of 2 and also to pass in the name 
of a formatting DLL routine that knows how to specially format that Generic Alert 
entry. 


2.8.6 DevHip_LogEntry Device Driver Interface 


DevHlIp_LogEntry provides a device driver interface to the logging facility. 


The description of the LogEntry DevHlp function follows: 


Calling sequence - LES  BX,log_data_address 
MOV CX,service 
MOV DL,DevHIp LogEntry /* LogEntry function 
code 0x3b */ 
CALL [Device Help] 


Parameters 


log_data_address 
This is the address of a buffer that contains a variable length Error Log entry. 
(See the section on the LogAddEntries high level API for further details.) 
level API for further details.) 


service 
This is the class of logging facility: 


0x0 Reserved 


0x1 ”“Old-Style” Error Logging call (“old” 16-bit (DosLogEntry-style) 
data packet provided). 


0x2 - Ox2f Reserved for future use. 


0x80 - Ox8f Reserved for internal use by the System Logging Service device 
driver. 


0x90 ”“New_Style” Error Logging call (”“new” 32-bit 
(LogAddEntries-style) data packet provided). 


0x91 - Oxffff Reserved for future use. 


Returns 


Return code in AX: 
Q Success 


non-zero 
Failure 


Possible errors: 


Invalid log type 
Facility unavailable 


Facility suspended 


Remarks 
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When CX is set to 80H, DS:SI is set to point to the device driver header block of 
the System Logging Service device driver 


2.9 RAS API Prototypes 


The following is a sample C language header file that contains sample prototype 
definitions for the RAS APIs. 


/* definitions for DosDumpProcess */ 

#define DDP_DISABLEPROCDUMP 0x00000000L /* disable process dumps */ 
#def ine DDP_ENABLEPROCDUMP 0x00000001L /* enable process dumps */ 
#define DDP_PERFORMPROCDUMP 0x00000002L /* perform process dump */ 


/* definitions for DosSuppressPopUps */ 
#define SPU_DISABLESUPPRESSION 0x00000000L /* disable popup suppression */ 
#define SPU_ENABLESUPPRESSION 0x00000001L /* enable popup suppression */ 


/* definitions for DosQueryRASInfo Index */ 
#define SIS MMIOADDR 0 


#define SIS MEC_TABLE 1 

#define SIS SYS LOG 2 

#define LF_LOGENABLE 0x0001 /* Logging enabled */ 

#define LF_LOGAVAILABLE 0x0002 /* Logging available */ 

APIRET APIENTRY DosQueryRASInfo(ULONG Index, PPVOID Addr); 

APIRET APIENTRY DosForceSystemDump(ULONG reserved) ; 

APIRET APIENTRY DosDumpProcess(ULONG Flag, ULONG Drive, PID Pid); 
APIRET APIENTRY DosSuppressPopUps (ULONG Flag, ULONG Drive); 


APIRET16 APIENTRY16 DosSysTrace(USHORT Majorcode, USHORT Length, 
USHORT Minorcode, PCHAR pData); 


APIRET16 APIENTRY16 DosGetSTDA(SEL, SHORT, SHORT ); 


/* 32-bit Logging Facility Function Prototypes %/ 
/* gy IS GP aS PRS I eA Ce Ae Tee NETS ETT UNS APTS ON RETO TTES rT Pee */ 

/* Logging Defines Ai 

/* eS ee ee eS TaD eT et ee aT eT eS OT eS SOS */ 

#define ERRLOG SERVICE 1L 

#define ERRLOG_VERSION 1 

/* RE ERO ETE SNE, SCE, EE EL Ee OE es */ 

/* LogRecord status bits */ 

/* Be ie te Na Maan Sn i er ate pac eM ae ae ee ee he ae ete */ 


#define LF_BIT_PROCNAME Ox0001L 
#define LF_BIT ORIGIN 256 Ox0002L 
#define LF_BIT DATETIME  Ox0004L 
#define LF_BIT SUSPEND 0x0008L 
#define LF_BIT_RESUME 0x0010L 
#define LF_BIT REDIRECT  0x0020L 
#define LF_BIT GETSTATUS  0x0040L 
#define LF BIT REGISTER  Ox0080L 
#define LF_BIT REMOTE FAIL 0Ox0100L 
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/* Log Entry Record Header for 2.X La 
/* This is format used by 2.0 device */ 
/* drivers and callers of LogAddEntries */ 
/* BASEMAN EE OLSEN Rt OLEAN ERIE RR A EARNS ARELLANO R TE AE, */ 
typedef struct LogRecord 
{ 
USHORT len ; /* this record length(includes len field)*/ 
USHORT rec_id ; /* record id He] 
ULONG status ; /* record status bits(see LF_BIT_) */ 
UCHAR qualifier[4] ; /* qualifier tag a 
ULONG reserved ; 
ULONG time ; /* hours minutes seconds hundreds */ 
ULONG date ; /* day month (USHORT) year */ 
UCHAR data[1] ; /* begin of variable data that includes: */ 
/* Originator(256 bytes if LF_BIT ORIGIN 256)*/ 
/* else 8 bytes long ee /, 
/* Processname(260 bytes) only if status */ 
/* LF_BIT_PROCNMAME set *] 
/* FormatDLLName(12 bytes) */: 
/* Variable data */ 


} LOGRECORD ; 
typedef LOGRECORD far *PLOGREC ; 


/* Re ah oh NAN CAN <b Sulot ebsites sa eb ton lot Sink leh Soke lob tod 3 chloe “och Stet 5. */ 

/* Format of buffer sent to LogAddEntries */ 

/* Poly EERE SCD TT A DeROSIER eee SOR IE Re ER OR SRS */ 

typedef struct LogEntryRec 

{ 
USHORT version ; /* this version is 1 */ 
USHORT count ; /* number of log records in this buffer*/ 
LOGRECORD logrec ; /* repeated count times */ 


} LOGENTRYREC ; 
typedef LOGENTRYREC far *PLOGENTRYREC ; 


/* BE LAL SER LDL A AE LEAL ENE LOE OLEATE NIL ROE AA ENTE SSE: */ 
/* Logging facility Function prototypes 2]: 
/* Bebe ll lube beleé td letetieviekun tltelewe bec eee LS */ 


APIRET APIENTRY LogOpen( PHFILE phf ); 
APIRET APIENTRY LogClose( HFILE hf ); 
APIRET APIENTRY LogAddEntries( HFILE hf, ULONG ulService, PVOID pLogEntries ); 


APIRET APIENTRY LogGetEntries( HFILE hf, ULONG ulService, ULONG ulType, 
PVOID pLogBuffer, ULONG ulBufferLen ); 


/* 16-bit Logging Facility Function Prototypes a 
APIRET16 APIENTRY16 DosLogRegister(PUSHORT LogHandle, 


PVOID LogRegList, 
PUSHORT RequestID) ; 


APIRET16 APIENTRY16 DosLogEntry(USHORT Function, 
PVOID LogData); 


APIRET16 APIENTRY16 DosLogRead(USHORT LogHandle, 


USHORT Length, 
PVOID LogBuffer, 
PUSHORT ReadSize) ; 
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Chapter 3. OS/2 System Control Block Reference 


This chapter contains details of some of the more important system control 
blocks used in debugging. 


Where major differences in format exist between ALLSTRICT and RETAIL, and 
between versions of OS/2 then each version of the control block is given. 
Otherwise only OS/2 Warp V3.0 ALLSTRICT Kernel versions of the control blocks 
are given and may be assumed to be applicable to also RETAIL and earlier 
versions of OS/2. 


Attention 


The information given in this chapter is for debugging purposes only. The 


layout of the control blocks may change from one release of OS/2 to the next. 
They are not to be considered a programming interface. 


The following system components are included in this chapter and an overview 
is provided in the next section, 3.1, “Overview of Kernel Components and 
Interfaces” on page 43. 


3.2, “Miscellaneous System Control Block Reference” on page 47 
This section describes system structures that are common to all 
components. These include SAS and RMP. 


3.3, “Semaphore Control Block Reference” on page 55 
This section describes the control blocks used for RamSem, FSRamSem 
Ksem, SysSem, PM/GRE, 32-bit, and MuxWait Semaphores. 


3.4, “Memory Management Control Block Reference” on page 69 
This section describes the following control blocks used by memory 
management: 


VMAL, VMOB, VMAR, VMCO, VMAT, VMAH, PF and VP 


3.5, “Scheduler Thread and Process Control Block Reference” on page 89 
This section describes the following control blocks used by thread and 
process management: 


PTDA, TCB, TSD, GISEG, LISEG, PIB, TIB, EXENT and exception handler 
structures 


3.6, “Loader Control Block Reference” on page 165 
This section describes the following control blocks used by the system 
loader component: 


MTE, SMTE, OTE, STE 
3.7, “File System Block Reference” on page 172 


This section describes the following control blocks used by the file system 
component: 


SFT, MFT, FSC, RLR, VPB, DBP, CDS, BUF, Named and Anonymous Pipes 
3.8, “I/O System Control Block Reference” on page 205 
This section describes the structures that relate to low level I/O. These 


include: Request Packets, BIOS Parameters Blocks and Device Driver 
Headers, Virtual Device Driver Entry Points. 
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r— Format 


The control block formatting conventions have been chosen to aid the user of 
the Kernel Debugger and Dump Formatter. 


Each control block is presented in tabular form with five columns used as 
follows: 


name 
Field name, usually taken from the C header or MASM include file 
definition. 


Off Offset from the beginning of the structure. The offset is of the form x.y 
where x is the signed hexadecimal byte offset from the beginning of the 
structure and yis the bit offset from the high-order bit of the byte. 


Leng 
Hexadecimal length of the field. 


Type 
The field type, for the purposes of displaying storage using the D 
command. The following values are used: 


Ss Complex structure. Choose display command to best suit your 
needs. 

D Double word. Use DD to format the field correctly. 

W Word. Use DW to format the field correctly. 

B Byte. Use DB to format the field correctly. 

A ASCII byte string. Use DA to format the field correctly. 


blank A blank value appears when a field does not begin or end on 
a byte boundary. In this case format the field from the 
previous field for which a type value is given. Such bit fields 
are presented in an order assuming this instruction is 
followed. Attempts to display bit fields in other ways may lead 
to a great deal of confusion! 


Description 
field description taken usually from the header or include file. 


A null row is used to indicate an overlay definition of the same control block. 


Flag fields are separately formatted in tabular form. 


Where a flag field represents a bit mask, the mask is given in 
hexadecimal and is assumed to indicated that corresponding bits are set 
to be in effect. Exceptions are specifically notes in the description. 


When the flag field take numerical values then they will be shown in 
either hexadecimal (prefixed with Ox) or decimal depending on the C or 
MASM definitions. 


3.1 Overview of Kernel Components and Interfaces 


The OS2KRNL modules lies at the heart of OS/2; it is essentially the operating 
system. 


The kernel comprises of a number of internal components, each responsible for 
a different aspect of running the system. It also has a number of interfaces that 


provide services to applications, device drivers and file systems. 


These aspects are now considered in a little more detail and are summarized 
the diagram shown in Figure 8 on page 46. 


3.1.1 Kernel Components 


Task management and the Scheduler 
This is responsible for thread and process management. The functions 
performed include: 


Thread and process creation and termination 
Thread scheduling (priority and state management) 
Preparing threads for dispatching 

Blocking and running 


Implementing the thread and process related APIs 


The scheduler’s principle control blocks are: 


PTDA Per Task Data Area 

TCB Thread Control Block 
TSD Thread Swappable Data 
TSS Task State Segment (H/W) 


System Loader 
This is responsible for load module management. The loader’s principle 
responsibilities include: 


Bringing modules into memory and performing fixups 
Managing modules resources 

Managing dynamic linking 

Tracking module references 

Deleting modules from memory 

Managing the discarding and swapping of module pages 


Implementing module related APIs 


The loader’s principle control blocks are: 


MTE Module Table Entry 

SMTE Swappable Module Table Entry 
OTE Object Table Entry 

STE Segment Table Entry 
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Memory Management 
Memory management is responsible for managing physical, virtual, and 
swapper memory. Its principle roles include: 


Allocation and assignment of physical pages of memory 
Allocation and assignment of virtual storage 
Managing the swapper 
Memory locking 
Implementing memory related APIs 
The principle control blocks of memory management are: 
VMAR Virtual Memory Arena Record 
VMOB Virtual Memory Object Record 


PF Page Frame Structure 

VP Virtual Page Structure 

PTE Page Table Entry (H/W) 
File System 


The file system kernel component responsibilities include: 
Access to FAT formatted media. 
Interfacing with file system drivers for accessing non-FAT media 
Managing and tracking the status of all open files. 
Path management 
File sharing and serialization. 
Providing helper kernel services for FSDs. 
Implementation of all file system APIs. 


The principle control blocks of the file system include: 


MFT Master File Table Entry 
SFT System File Table Entry 
CDS Current Directory Structure 
FSC File System Control Block 


Device and I/O Management 
This component is responsible for interfacing with physical device drivers. 
Its responsibilities include: 


Routing requests to PDDs from applications 
Managing interrupts 
Providing helper kernel services for PDDs 
The principle control blocks for device management include: 
IRQI IRQ Information Array 
DIRQ Device IRQ Information 
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REQ PDD request Packet. 
DEV PDD device header 


Virtual Dos Machine 
This component is responsible for providing the entire DOS Machine 
emulation. This has not been covered in this book, except for the Virtual 
Device Driver interface. 


3.1.2 Kernel Interfaces 
The Kernel provides the following external interfaces: 


Application (R3/2) Interface 
Application access kernel services via GDT call gates. These are called 
either directly from the application program or via the DOSCALL1.DLL 
module, where additional Ring 3 processing is required before calling the 
kernel. Some system interfaces are able to be implemented entirely within 
Ring 2/3. In these cases, DOSCALL1.DLL does not make any kernel calls. 


The kernel interfaces are represented by a fictitious module called 
DOSCALLS.DLL. 


File System Driver (FSD) 
The FSDs run in ring 0 as separately loaded modules. They provid a set of 
interfaces to the kernel via the FSD_HlIp (File System Helper) calls. 


Physical Device Driver (PDD) 
The PDDs run in ring 0 as separately loaded modules. They provid a set of 
interfaces to the kernel via the Dev_Hlp (Device Helper) calls. 


Virtual Device Driver (VDD) 
The VDDs run in ring 0 as separately loaded modules. They provid a set of 
interfaces to the kernel via the VDD_Hlp (Virtual Device Driver Helper) calls. 


Compatibility BIOS 
The compatibility BIOS resides within the OS2LDR module. It provides a 
hardware implementation independent layer through which the kernel 
accesses the BIOS. The interface to the CBIOS from the kernel is provided 
by the Dos_Hip (Dos Helper Services). These are not available for access by 
PDDs, VDDs or FSDs, however a limited set of Dos_Hlp calls are provided via 
the TESTCFG.SYS and OEMHLP$ device drivers. 


Notes: OEMHLP$ is not a separately loaded module; it is resident within the 
OS2LDR module. 


OS2LDR is responsible for loading the Kernel at system initialization 
time. It does not get involved with the loading of application 
programs, PDDs, VDDs for FSDs during normal running; that function 
is performed by the system loader component of the Kernel. 
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3.1.2.1 The OS/2 Kernel’s Interfaces 


OS/2 Kernel Interfaces 


The OS/2 Kernel's Interfaces 
(steady state) 
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Figure 8. OS/2 Kernel Interfaces 
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3.2 Miscellaneous System Control Block Reference 
The following control blocks are described in this section: 
3.2.2, “System Anchor Segment (SAS) for OS/2 Warp V3.0” on page 49 
3.2.3, “Record Management Package (RMP) for OS/2 Warp V3.0” on page 52 


An overview of the miscellaneous system control blocks is as follows: 


3.2.1 Miscellaneous System Diagrams 
The following diagram illustrates the System Anchor Segment. 
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3.2.1.1 The System Anchor Segment 


The System Anchor Segment 


SAS Header Section SAS VM Section 


+10 
+12 
+14 


3 


a 


SAS Protect Mode Tables 


# GDT 


# IDT 


# GDTPOO 


SAS H/W Config Section 
: 


SAS Device Driver Section 


PB seg 
& CDA 
# FSC seg 


Us, +0 # GISEG 
SAS RAS Section +2 — 


+0 
+2 
+4 


# LISEG 


RJM 28th Aug 95 - sas 


Figure 9. The System Anchor Segment 
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3.2.2 System Anchor Segment (SAS) for OS/2 Warp V3.0 


Table 3. SAS Base Section 


The SAS is the common anchor for many system control blocks and control 
block chains. 


Pointers 
70:0 maps the SAS as a read-only segment. 


78:0 maps the SAS as a read/write segment. 


Locations 
Built statically within the OS2KRNL load module. 


VM Owner 
os2krnl (Oxffaa) 


Format 


Field Name Offset Length Type Description 
SAS_ signature +0 4 A "SAS ” 
SAS_tables_data +4 2 WwW offset to tables section 


SAS_flat_sel +6 2 WwW FLAT selector for kernel 
data 


SAS_config_data +8 2 WwW offset to configuration 
section 

SAS_dd_data +a 2 W offset to device driver 
section 

SAS_vm_data +C 2 W offset to Virtual Memory 
section 


2 WwW offset to Tasking section 
SAS_RAS_data +10 2 WwW offset to RAS section 
SAS_file_data +12 2 WwW offset to File System section 
SAS_info_data +14 2 WwW offset to infoseg section 


Field Name 


Table 4. SAS_tables_section Protected Mode Tables 


section. 


SAS_tbl_GDT 


SAS_tbI_LDT 


SAS_tbl_IDT 
SAS_tbl_GDTPOOL 


Offset Length Type Description 

+0 2 WwW selector for GDT 

+4 2 WwW selector for LDT 

+6 2 WwW selector for IDT 

+8 2 Ww selector for GDTPOOL 
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section. 


Table 5. SAS_config_section Configuration Section 


Field Name 


SAS_config_table 


Table 6. SAS_dd_section Device Driver Section 


Offset 


Length 


Type 


Description 


offset for Device 
Configuration Table 
(DevConfigTbl) 


Field Name Offset Length Type Description 

SAS_dd_bimodal_chain +0 2 WwW offset for the first bimodal 
device driver’s device 
header 

SAS_dd_real_chain +2 2 Ww offset for the address of the 
first real mode device 
driver’s device header 

SAS_dd_DPB_segment +4 2 WwW selector for Drive Parameter 
Block (DPB) segment 

+6 2 W selector for ABIOS 

protected mode Common 
Data Area 

SAS_dd_CDA_anchor_r +8 2 WwW segment for ABIOS real 
mode Common Data Area 

SAS_dd_ FSC +a 2 Ww selector for FSC 


Table 7 (Page 1 of 2). SAS_vm_section Virtual Memory Management Section 


Type Description 
SAS_vm_arena D Flat offset of arena records 
SAS_vm_object D Flat offset of object records 
SAS_vm_context D Flat offset of context 
records 
D Flat offset of kernel MTE 
records 
SAS_vm_glbl_mte D Flat offset of global MTE 
linked list. Note this field 
points into the chain to pick 
up global MTEs only. Use 
SAS_vm_all_mte to find all 
the MTEs. 
SAS_vm_pft D Flat offset of page frame 
table 
SAS_vm_prt D Flat offset of page range 
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table 


Table 7 (Page 2 of 2). SAS_vm_section Virtual Memory Management Section 
Field Name Offset Length Type Description 


SAS_vm_swap +1c 4 D Pointer to flat offset of 
swapper disk frame bit map 
followed by the size of the 
bit map in bits WARNING, 
the bit map offset and size 
are volatile 


SAS_vm_idle_head 


Flat offset of Idle Head 


4 D 
4 D Flat offset of Free Head 
4 D 
4 D 


SAS_vm_heap_info +28 Flat offset of Heap Array 

SAS_vm_all_mte +2C Flat offset of all MTEs linked 
list 

Table 8. SAS_task_section Tasking Section 

Field Name Offset Length Type Description 

WwW selector for current PTDA 

SAS_task_ptdaptrs +2 D FLAT offset for process tree 
head 

SAS_task_threadptrs D FLAT address for TCB 


address array 


SAS_task_tasknumber D offset for current TCB 
number 


SAS_task_threadcount D offset for ThreadCount 


Table 9. SAS_RAS_section RAS Section 


Field Name Offset Type Description 

SAS_RAS_STDA_p +0 Ww selector for System Trace 
Data Area (STDA) 

SAS_RAS_STDA_r +2 D segment for System Trace 


Data Area (STDA) 


SAS_RAS_event_mask D offset for trace event mask 


Table 10 (Page 1 of 2). SAS_file_section: File System Section 


Field Name | Offset | Type Description 


SAS_ file MFT +0 4 D handle to MFT PTree 


SAS _file SFT +4 2 Ww selector for System File 
Table (SFT) segment 
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Table 10 (Page 2 of 2). SAS_file_section: File System Section 
Field Name Offset Length Type Description 


SAS_file_VPB +6 2 Ww selector for Volume 
Parameter Block (VPB) 
segment 


SAS _file CDS 2 Ww selector for Current 
Directory Structure (CDS) 
segment 


SAS_file_buffers 2 Ww selector for buffer segment 


Table 11. SAS_info_section Information Segment Section 


Field Name Offset Length Type Description 

SAS_info_global +0 2 Ww selector for global info seg 

SAS_info_local +2 4 D address of curtask local 
infoseg 

SAS_info_localRM +6 4 D address of DOS task’s 
infoseg 

SAS_info_CDIB +a 2 Ww selector for Codepage Data 


3.2.3 Record Management Package (RMP) for OS/2 Warp V3.0 


The RMP is used to manage tables of variable length entities. It appears in a 
number of situations, particularly those that required ASCII strings, such as file 
names, to be managed. 


Pointers 
rp_selector of the RMP handle maps the RMP segment. 


Locations 
RMP handles are located at the following labels: 


CharDevRMPRec Character Device Drivers 
SpoolDevRMPRec Spooler Device Drivers 
NmpRmpHand Named Pipes 
hDiscSegRmpStruc Discardable Segments 


ShareRmpStruc Named Shared Memory 
SysSemRmpHdl System Semaphores 
VM Owner 


CharDevRMPRec chardevrmp (0xff35) 
SpoolDevRMPRec spldevrmp (0xff34) 
NmpRmpHand npipenpn (Oxff30) 
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hDiscSegRmpStruc 


discard (Oxff6c) 


ShareRmpStruc mshrmp (0xff83) 
SysSemRmpHdl syssemrmp (0xff36) 
Format 
Table 12. rbheadr RMP Header Structure 
Field Name Offset Length Type Description 
rb_size +0 2 WwW total size of segment 
rob_1st_free +4 2 Ww link to first free block in seg 
rb_last_free +6 2 WwW start of last free block 
ro_hkh +8 4 D heap handle 
4 D PG alloc/realloc flags 
rb_hobowner +10 2 WwW hobowner 
rb_hobmte +12 2 Ww hobmte 
rb_first +14 n Ss start of first record 
2 W size of ‘Tecord size field 
+n+2 n-2 iS) record data 


Table 13. rbfree RMP Free Record Structure 


Field Name 


Description 


rf_size 


rf_next_free 


free block size (high bit set) 


link to prev free block in seg 


link to next free block in seg 


Table 14. rparm RMP Handle Structure 


Offset 


Field Name 


Description 


rp_flags +0 


rp_selector 


flags 


GDT selector to use 
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Table 15. rp_flags Flag Definitions 


Name Bit Mask Description 


RPF_BUSY 0x01 Segment busy flag 


RPF_WAITING 0x02 Somebody waiting flag 


RPF_ALLOC Segment allocated flag 
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3.3. Semaphore Control Block Reference 
The following control blocks are described in this section: 
3.3.1, “FastSafeRamSemStruc” 
3.3.2, “FastSafeRamSemStruc PM Version” 
3.3.3, “MuxTableEntry” on page 56 
3.3.4, “RamSemStruc” on page 56 
3.3.5, “KSEM Structures for OS/2 Warp V3.0 ALLSTRICT Kernel” on page 57 


3.3.6, “32-Bit Semaphore Structures for OS/2 Warp V3.0 ALLSTRICT Kernel” 
on page 59 


3.3.7, “System Semaphore Structures” on page 66 
3.3.8, “PM/GRE Semaphore Structure” on page 68 


3.3.1 FastSafeRamSemStruc 


Pointers 
TCB_SemiInfo points to fs RAMSem 


Locations 
Multiple, in user storage. 


VM Owner 
Multiple user storage owners. 


Format 


Field Name Length Type Description 


FastSafeRamSemStruc Fast Safe Ram Semaphore 


fs_Length Length of this structure 


fs_ProclD Process ID of owner or zero 


Thread ID of owner or zero 


fs_Usage 


reference count 


fs_Client 16-bit field for use by owner 


OS/2 RAM Semaphore 


AlrwMlwMlwol rw] nw] o 
O)S/S/2/=2/=/° 


fs_RAMSem 


3.3.2 FastSafeRamSemStruc PM Version 


Pointers 
TCB_SemiInfo points to fs RAMSem 


Locations 
Multiple, in user storage. 


VM Owner 
Multip| user storage owners. 


Format 
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FastSafeRamSemStruc 12 S) PM Fast Safe Ram 
Semaphore 

fs_Length 2 Ww Length of this structure 

fs_ProclD 2 WwW Process ID of owner or zero 
2 WwW Thread ID of owner or zero 

fs_ Usage 2 WwW reference count 

fs_Client 2 Ww 16-bit field for use by owner 

fs_Timeout 4 D Timeout value 


3.3.3. MuxTableEntry 


Locations 
At label MuxTable in system storage 


VM Owner 
os2krnl (Oxffaa) 


Format 


Field Name Type Description 
MuxTableEntry iS) Mux Table Entry 


MuxLink WwW Selector Link to next entry. 
Used to chain entries for a 
MuxWait request 


MuxThreadID Ww Thread Slot ID of waiter 


MuxType B Semaphore type. 


MuxSemID +5 4 D Mux Semaphore handle. 


Description 
MUXTYPE_CLEAR the mux table entry is clear 
MUXTYPE_SYSSEM the ID is a system sem address 
MUXTYPE_RAMHANDLE the ID is a ram sem handle:offset 
MUXTRYE_RAMPHYS the ID is a ram sem physical address 
MUXTYPE_EVENTSEM 4 the ID for a 32-bit event sem 


3.3.4 RamSemStruc 


Pointers 
TCB_SemIinfo 


Locations 
Multiple, in user storage. 
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VM Owner 
Multiple user storage owners. 


Format 
Field Name Offset Length Type Description 
RamSemStruc +0 4 Ss Ram Semaphore 
RamSemFlag +1 1 B Ram Semaphore flag bit 
field 
RamSemlID +2 2 WwW RamSem Block/Run ID low 
word 


Table 17. RamSemFlag Definitions 
Name Description 


RAMSEM_WAITING a thread is waiting on the sem 


RAMSEM_MUXWAITING a thread is muxwaiting on the sem 


Notes: 


The high-order 4 bit of the RamSemFlag are used as an extended owner 
field (to cater for more than 512 threads). 


Only kernel code sets the RamSemOwner field to a thread slot number. 
Ring 3 RamSems have Oxff value for an owned RamSem 


3.3.5 KSEM Structures for OS/2 Warp V3.0 ALLSTRICT Kernel 


For KSEM formats for other versions of OS/2 see: 


3.3.5.1, “KSEM Structures for OS/2 Warp V3.0 RETAIL Kernel” on page 58 


Locations 
Multiple, either imbedded in system structures, for example PTDA, MFT, or 
dynamically allocated from the kernel heaps. 


VM Owner 
Imbedded KSEMs assume the Owner Id of the imbedding structure. 
Stand-alone KSEMs allocated from the kernel heaps use id: ksem (Oxff7e) 


Format 


Table 18 (Page 1 of 2). KSEMSHR Shared Kernel Semaphore 


Field Name Offset Length Type Description 
ks_ Signature +0 4 D 
ks_bFlags +4 1 B 
is ete did 
ks_Owner +6 2 WwW 
ks_cusPendingWriters +8 2 WwW 
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Table 18 (Page 2 of 2). KSEMSHR Shared Kernel Semaphore 


Field Name Offset Type Description 
ks_cusNest Ww 
ks_cusReaders Ww 
Ww 
Type Description 
ksm_Signature D 
ksm_bFlags B 
ksm_bType B 
Pksmowner id «dP w 
ksm_cusPendingWriters +8 2 Ww 
ksm_cusNest +a 2 Ww 
Table 20. KSEMEVT Event Kernel Semaphore 
Field Name Type Description 
kse_Signature D 
kse_bType B 
kse_Owner Ww 
kse_cusPendingWriters Ww 
Table 21. Ksem Flag Definitions 
Name Bit Mask Description 


KSEM_NOINTERRUPT 0x1 


KSEM_WRITER 
KSEM_DISPLAYID 
KSEM_NOBLOCK 


3.3.5.1 KSEM Structures for OS/2 Warp V3.0 RETAIL Kernel 


Table 22 (Page 1 of 2). KSEMSHR Shared Kernel Semaphore 
Offset 


Field Name Length Type Description 


ks_bFlags +0 
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Table 22 (Page 2 of 2). KSEMSHR Shared Kernel Semaphore 


Field Name Offset Length Type Description 
ks_Owner +2 2 Ww 
ks_cusPendingWriters +4 2 Ww 
Pisccunest id «*d w 
ks_cusReaders +8 2 WwW 
ks_cusPendingReaders +a 2 Ww 


Table 23. KSEMMTX MUTEX Kernel Semaphore 


Field Name Offset Length Type Description 

ksm_bFlags +0 1 B 
Pim ote tid 

ksm_Owner 2 WwW 

ksm_cusPendingWriters 2 Ww 

ksm_cusNest 2 Ww 

Table 24. KSEMEVT Event Kernel Semaphore 

Field Name Offset Length Type Description 
rise pFiegs did 

kse_bType 1 B 

kse_Owner 2 Ww 

kse_cusPendingWriters 2 WwW 


3.3.6 32-Bit Semaphore Structures for OS/2 Warp V3.0 ALLSTRICT Kernel 
For 32-bit Semaphore formats for other versions of OS/2 see: 


3.3.6.1, “32-bit Semaphore Structures for OS/2 Warp V3.0 RETAIL Kernel” on 
page 64 


Pointers 
TCB_Sleepld points to SEVENT, PEVENT, SMUTEX, PMUTEX, SMUX or PMUX 
when waiting on the semaphore. 


PTDA field pPrSemTbl points to the private semaphore table, which is 
indexed by the semaphore handle. 


pShSemtTbI points to the shared semaphore table, which is indexed by the 
low-order word of the semaphore handle. Each entry is a pointer to a 
semaphore main structure. 
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PTDA field pPrSemTbI points to the per-process private semaphore table, 
which is indexed by the low-order word of the semaphore handle. Each 


entry is a pointer to a semaphore main structure. 


pShSemStrTbl points to the table of SEMTBLNODE entries. Each of these 
points to a hashed chain of SEMSTRNODE structures. 


Note: Names are hashed by treating each name as table of null padded 


ULONGs and successively adding. 


Locations 
Structures are allocated from the kernel heaps. 


VM Owners 


SEVENT 
PEVENT 
SMUTEX 
PMUTEX 
SMUX 

PMUX 
OPENQ 
MUXQ 
SEMRECORD 
SEMTBLNODE 
SEMSTRNODE 


Semaphore name 


Format 


semstruc (Oxffc2) 


semstruc (Oxffc2) 


semstruc (Oxffc2) 


semstruc (Oxffc2) 


semstruc (Oxffc2) 


semstruc (Oxffc2) 


semopeng (Oxffbf) 


semmuxq (0xffbe) 


semrec (0xffc0) 


semtable (0xffc3) 


semtable (0xffc3) 


semstr (Oxffc1) 


Table 25. SEVENT Shared Event Semaphore 


Field Name | Offset | Length Type Description 
usFlags WwW attributes 
pMuxQ D pointer to the mux queue 
usPostCt Ww number of posts 
D pointer to the open queue 
pszName D name of semaphore, null if 
anonymous 
pulCreatAddr D Address passed in by app 
during create 
ulSig D 0x54564553 ”“SEVT” 
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ptcb of caller 


Table 26. PEVENT Private Event Semaphore 
Field Name Offset Type Description 


usFlags +0 Ww attributes 


pMuxQ 


pointer to the mux queue 


+2 D 
WwW 
D 


pOpenCt number of opens 


pulCreatAddr Address passed in by app 


during create 


0x54564550 ”“PEVT” 


1s] 


ulSig 


Table 27. SMUTEX Shared Mutex Semaphore 


Field Name | Offset | Length Type Description 


usFlags +0 2 Ww attributes 
pMuxQ +2 4 D pointer to the mux queue 
usRequestCt +6 2 Ww number of requests 
2 WwW slot number of the owning 
thread 
usRequesterCt 2 WwW number of requesters 
pOpenQ 4 D pointer to the open queue 
pszName 4 D name of semaphore, null if 
anonymous 
+14 4 D Address passed in by app 
during create 
ulSig +18 4 D 0x58544D53 “SMT X” 
Table 28. PMUTEX Private Mutex Semaphore 
Field Name Offset Length Type Description 
usFlags +0 2 Ww attributes 
4 D pointer to the mux queue 
usRequestCt +6 2 WwW number of requests 
usSlotNum +8 2 WwW slot number of the owning 
thread 
usRequesterCt +a 2 WwW number of requesters 
pulCreatAddr +e 4 D Address passed in by app 
during create 
ulSig +12 4 D 0x58544D50 “PMT X” 
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Table 29. SMUX Shared Mux Wait Semaphore 


Field Name Offset Length Type Description 

usFlags +0 2 Ww attributes 

cSemRec +2 2 WwW count of semaphore records 

pSemRec +4 4 D array of semaphore record 
entries 

usWaitCt +8 2 WwW number of threads waiting 
on the mux 

pOpenQ +a 4 D pointer to the open queue 

pszName +e 2 WwW name of semaphore, null if 
anonymous 

pulCreatAddr +10 4 D Address passed in by app 
during create 

ulSig +14 4 D 0x58554D53 “SMUX” 

Table 30. PMUX Private Mux Wait Semaphore 

Field Name Offset Length Type Description 

usFlags +0 2 Ww attributes 

pSemRec +4 4 D array of semaphore record 
entries 

usWaitCt +8 2 WwW number of threads waiting 
on the mux 

usOpenCt +a 2 WwW number of opens 

pPTDA 4 D pointer to PTDA of creator 

pulCreatAddr +10 4 D Address passed in by app 
during create 

ulSig +14 4 D 0x58554D50 ”“PMUX” 

Table 31. OPENQ Open Queue Node Structure 

Field Name Offset Length Type Description 

pidOpener +0 2 Ww process id of opening 
process 

usOpenCt 2 WwW number of Opens for this 
process 

pNextOpen 4 D pointer to next node in list 

ulSig 4 D 0x514E504F “OPNQ”’ 
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Table 32. MUXQ Mux Queue Node Structure 


Field Name Offset Type Description 

pMux +0 D pointer to a mux (shared or 
private) 

pNextMux +4 D pointer to next mux waiter 
in list 


Field Name Offset 


Table 33. SEMRECORD Semaphore Record Structure for MUX Wait Semaphores 


Type Description 


hsemCur +0 


D semaphore handle 


ulUser +4 


user value 


Table 34. SEMSTRNODE Semaphore String Node 


hsem +0 D semaphore handle 
psz +4 D pointer to the string 
pNext +8 D pointer to next string node 


Table 35. SEMTBLNODE Semaphore String Node Table Entry 
Field Name Offset 


Type Description 


ulKey +0 


D hash key 


pStrNode +4 


pointer to string node 


Table 36 (Page 1 of 2). usFlags Field Definitions 


DE_POSTED 0x0040 


Description 


The event sem APIs set this flag if the 
event is in the posted state 


DM_OWNER_DIED 0x0080 


The process died while owning the mutex 
semaphore 


DMW_MTX_MUX 0x0100 
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The muxwait semaphore APIs set this 
flag if the mux contains mutex sems 
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Table 36 (Page 2 of 2). usFlags Field Definitions 


Name Bit Mask Description 


DHO_SEM_OPEN 0x0200 dh_OpenEventSem sets this flag to 
indicate that device drivers have opened 
the given semaphore 


DE_16BIT_MW 0x0400 Part of a 16-bit MuxWait if this flag is set 


3.3.6.1 32-bit Semaphore Structures for OS/2 Warp V3.0 RETAIL 
Kernel 


Table 37. SEVENT Shared Event Semaphore 
Field Name Offset Type Description 


usFlags +0 Ww attributes 


pMuxQ pointer to the mux queue 


+2 D 
D 
D 


name of semaphore, null if 
anonymous 


D ptcb of caller 


pOpenQ +8 pointer to the open queue 
pszName +C 
ptcb +10 


Table 38. PEVENT Private Event Semaphore 


Field Name | Offset | Type Description 


usFlags +0 Ww attributes 


pMuxQ +2 pointer to the mux queue 


D 
usPostCt +6 Ww number of posts 
Ww 


number of opens 


Table 39. SMUTEX Shared Mutex Semaphore 


Field Name Offset Length Type Description 

usFlags +0 2 Ww attributes 

pMuxQ +2 4 D pointer to the mux queue 

usSlotNum +8 2 WwW slot number of the owning 
thread 

usRequesterCt +a 2 WwW number of requesters 

pOpenQ +C 4 D pointer to the open queue 


pszName +10 4 D name of semaphore, null if 
anonymous 
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Table 40. PMUTEX Private Mutex Semaphore 


Field Name Offset Length Type Description 
WwW attributes 
pMuxQ D pointer to the mux queue 
usRequestCt Ww number of requests 
usSlotNum WwW slot number of the owning 
thread 
WwW number of requesters 
usOpenCt +C 2 WwW number of opens 
Table 41. SMUX Shared Mux Wait Semaphore 
Field Name Offset Length Type Description 
usFlags +0 2 Ww attributes 
2 WwW count of semaphore records 
pSemRec 4 D array of semaphore record 
entries 
usWaitCt 2 WwW number of threads waiting 
on the mux 
pOpenQ 4 D pointer to the open queue 
2 Ww name of semaphore, null if 
anonymous 
Table 42. PMUX Private Mux Wait Semaphore 
Field Name Offset Length Type Description 
usFlags +0 2 Ww attributes 
cSemRec 2 Ww count of semaphore records 
4 D array of semaphore record 
entries 
usWaitCt 2 WwW number of threads waiting 
on the mux 
usOpenCt 2 WwW number of opens 
pPTDA 4 D pointer to PTDA of creator 
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Table 43. OPENQ Open Queue Node Structure 


Field Name 


pidOpener 


usOpenCt 


Offset Type Description 

+0 Ww process id of opening 
process 

+2 WwW number of Opens for this 
process 


pNextOpen D pointer to next node in list 


Table 44. MUXQ Mux Queue Node Structure 


Field Name Offset Type Description 

pMux +0 D pointer to a mux (shared or 
private) 

pNextMux D pointer to next mux waiter 
in list 


Table 45. SEMSTRNODE Semaphore String Node 


Field Name a Type Description 


D semaphore handle 


hsem 
+4 D pointer to the string 
pNext +8 D pointer to next string node 


3.3.7 System Semaphore Structures 
Pointers 
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SysSemRmpHdl contains the selector that points the system semaphore 
names RMP. 


Locations 


VM 


SysSemDataTable is the location of the global system semaphores table. 
Each entry is a SysSemTbIStruc structure. 


PTDA field SysSemPTDATDI is the location of the per-process semaphore 
table. 


PTDA per-process semaphore contains byte-length entities, which are 
per-semaphore use counts. 


The semaphore handle indexes both the per-process and global semaphore 
tables. 


SysSemHighTable locates the table of SysSemHighTableS structures. 


Owner 
syssemrmp (0xff36) for the RMP that contains the semaphore names. 


Other global tables are owned by os2krnl (Oxffaa). 


Format 


Table 46. SysSemHandleStruc System Semaphore Handle Structure 


Field Name Offset Length Type Description 
SysSemHighWord +0 2 Ww 0x8000 for sys sems 
SysSemPTDAIndex 2 WwW Index into the PTDA open 
sem table 
Table 47. SysSemTblStruc System Semaphore Table Structure 
Field Name Offset Length Type Description 
SysSemOwner +0 2 Ww thread owning this 
semaphore 
SysSemFlag +2 1 B system semaphore flag bit 
field 
SysSemRefCnt +3 1 B number of references to this 
sys sem 
SysSemProcCnt +4 1 B number of requests for this 
owner 
SysSemPad +5 1 B pad byte to round structure 
up to word 
SysSemHighTableS System Semaphore Table Extension Structure. 
This is an extension of the SysSemTblStruc that is put into high memory so we 
don’t impact the low data segment. It is only used in protected mode during 
process/thread termination. 
Field Name Offset Length Type Description 
SysSemPidOwner +0 2 WwW pid owner, the thread owner 


has died 


SysSemNameStruc System Semaphore Name table structure, managed by an 


RMP. 


Field Name 


Offset 


Length 


Type 


Description 


SysSemPtr 


+0 
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Table 48. SysSemFlag Flag Field Definitions 


Name Bit Mask Description 


SYSSEM_WAITING 0x01 a thread is waiting on the sem 


SYSSEM_MUXWAITING 0x02 a thread is muxwaiting on the sem 


SYSSEM_OWNER_DIED the process/thread owning the sem died 


SYSSEM_EXCLUSIVE indicates a exclusive system semaphore 


SYSSEM_NAME_CLEANUP name table entry needs to be removed 


SYSSEM_THREAD_OWNER_DIED the thread owning the sem died 
SYSSEM_EXITLIST_OWNER the exitlist thread owns the sem 


3.3.8 PM/GRE Semaphore Structure 


Locations 
pmsemaphores locates the table of PM/GRE semaphores. 


VM Owner 
PMMERGE.DLL hmte 


Format 


Table 49. GRESEM PM/GRE Semaphore 


Field Name Offset Length Type Description 

acldent +0 7 A GRESEM or PMSEM 

ulProcessThread +8 4 D owner process and thread id 
(PTid) 

ulNestedUseCount +C 4 D # of times same PTid has 
accessed sem 

ulWaitingCount +10 4 D # of PTids waiting on 
semaphore 

ulUseCount +14 4 D # of times semaphore has 
been used 

ulEventHandle +18 4 D Event Handle Semaphore 

ulCallerAddr +1c 4 Semaphore Caller 
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3.4 Memory Management Control Block Reference 
The following control blocks are described in this section: 
3.4.2, “Page Frame Structure” on page 80 
3.4.4, “VM Alias Record” on page 82 
3.4.3, “VM Arena Header” on page 81 
3.4.5, “VM Arena Record” on page 83 
3.4.6, “VM Arena Type Information Record” on page 85 
3.4.7, “VM Context Record” on page 86 
3.4.8, “VM Object Record” on page 86 
3.4.9, “Virtual Page Structure” on page 88 


An overview of the memory management control blocks is as follows: 


3.4.1 Memory Management Control Block Diagrams 


The following diagrams illustrate the relationships between various memory 
management control blocks: 


3.4.1.1, “Virtual Address Space Regions” on page 70 
3.4.1. 
3.4.1. 
3.4.1. 
3.4.1. 


“Virtual Address Space Management” on page 71 
“Private Arena Private Data” on page 72 
“Private Arena Shared Data” on page 73 


“Shared Global Data” on page 74 


3.4.1. 
3.4.1. 
3.4.1. 


“Virtual/Physical Page Management - Backed Storage” on page 76 


2, 
3, 
4, 
2; 
3.4.1.6, “Shared Arena Instance Data” on page 75 
7, 
8, “Virtual/Physical Page Management - Swapped Storage” on page 77 
9, « 


CS Alias of Shared Instance Data” on page 78 
3.4.1.10, “Memory Alias in Multiple Processes” on page 79 
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3.4.1.1 Virtual Address Space Regions 


Virtual Address Space Regions 
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Figure 10. Virtual Address Space Regions 
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3.4.1.2 Virtual Address Space Management 
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Figure 11. Virtual Address Space Management 
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3.4.1.3 Private Arena Private Data 


Private Arena Private Data 
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Figure 12. Private Arena Private Data 
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3.4.1.4 Private Arena Shared Data 


Private Arena Shared Data 
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Figure 13. Private Arena Shared Data 
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3.4.1.5 Shared Global Data 


Shared Global Data 
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Figure 14. Shared Global Data 
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Shared Arena 
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3.4.1.6 Shared Arena Instance Data 
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Figure 15. Shared Arena Instance Data 
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3.4.1.7 Virtual/Physical Page Management - Backed Storage 
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Figure 16. Virtual/Physical Page Management - Backed Storage 
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3.4.1.8 Virtual/Physical Page Management - Swapped Storage 
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Figure 17. Virtual/Physical Page Management - Swapped Storage 
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3.4.1.9 CS Alias of Shared Instance Data 


CS Alias of Shared Instance Data 
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Figure 18. CS Alias of Shared Instance Data 
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3.4.1.10 Memory Alias in Multiple Processes 


Memory Aliases in Multiple Processes 


Va 


RJM 28th Aug 95 - vmalmem 


Figure 19. Memory Alias in Multiple Processes 
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3.4.2 Page Frame Structure 


Pointers 


_pft points to the table of Page Frame Structures. 


Locations 
System Arena 


VM Owner 
pgpf (Oxffb4) 


Format 
apf_s Cc Ss active pf 
pf_pvp 4 D vp cross link 
pf_refcount 2 Ww count of ptes marked 
present 
0.4 B flags 
0.4 pad 
pf_llock 1 B count of long term locks 
pf_slock 1 B count of short term locks 
3 B pad 
ipf_s Cc Ss idle page frame 
4 D pad 
pf_flink1 1 D forward link part 1 
0.4 flags 
vp_blink 2.4 backward link 
1.4 D pad 
pf_flink2 2.4 forward link part 2 
Cc free page frame 
4 pad 
pf_flink1 1 forward link part 1 
pf_flags 0.4 flags 
+8 1.4 D pad 
pf_flink2 +8.4 2.4 forward link part 2 


Table 50 (Page 7 of 2). pf_flag Flag Definitions 
Name Bit Mask 


Description 


PF_FAST 0x1 


frame is fast memory 


PF_BUSY 0x2 
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frame is busy 


Table 50 (Page 2 of 2). pf_flag Flag Definitions 
Name Bit Mask 
PF_FREE 0x4 


Description 


frame is free 


PF_RES 0x8 reserved 


3.4.3 VM Arena Header 


Locations 
_ahvmSys locates the System Arena VMAH. 


_ahvmShr locates the Shared Arena VMAH. 
PTDA field ptda_ah locates each Private Arena VMAH. 


VM Owner 
For shared and system arenas: os2krnl (Oxffaa) 


For private arenas: ptda (Oxffcb) 


Format 
ah_pahNext D Link to next arena 
ah_pahPrev D Link to previous arena 
ah_parSen D Handle of arena sentinel 
D Hint of 1st free block in 
arena 
ah_papbm 4 D Pointer to bitmap directory 
ah_paharHash 4 D Hash table pointer 
ah_pat 4 D Pointer to per-type info 
4 D Flags 
ah_laddrMin 4 D Minimum address currently 
mapped 
ah_laddrMax 4 D Max address currently 
mapped 
ah_car 4 Count of arena entries 
4 D Max entry count to need 
bitmap 
ah_lobmNumbMax 4 D Max bitmap number 
ah_lbmeNumbMax 4 D Max bitmap entry number 
ah_IHashNumbMax 4 D Max hash table index 
pseudo-handle 
ah_filler +3e 2 Ww Make structure 4-byte 
multiple 
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Table 51. ah_fl Flag Definitions 


Name Bit Mask 


Description 


VMAH_BITMAP_BYPASS 0x00000001 


Worth bypassing bitmap 


VMAH_NO_HASH_WRAP 0x00000002 


VMAH_GROW_DOWN 0x00000004 


3.4.4 VM Alias Record 


Pointers 


No hash table wraparound yet 


Arena grows down 


_palVMAliases points to the VMAL table. 


VM Owner 
vmal (Oxffe2) 


Format 
Field Name | Offset | Length Type Description 
vmal +0 8 Ss VM alias record 
al_har +0 2 Ww handle to alias’ arena 
record 
al_hobptda +2 2 WwW context the alias is created 
from 
al_pgoff +4 2.4 D page offset of the alias from 
start of object 
+4 1.4 flags indicating type of alias 
+0 8 iS) SEL alias record 
+0 2 Ww handle to alias’ arena 
record 
al_hobptda +2 2 WwW context the alias is created 
from if MEMMAP alias 
sal_cref +4 1.2 D reference count 
sal_f +4 0.6 flags 
sal_seldata +6 2 WwW data selector if cs alias 
(unused for MEMMAP) 
Table 52 (Page 7 of 2). al_f Flag Definitions 
Name Bit Mask Description 


AL_ISBUSY 0x1 


AL_CSALIAS 


Set if record is busy 


Set if cs alias record 


AL_MEMMAP 


Set if MemMapAlias record 


AL_DBGALIAS 


Set if debug alias 


Set if ds selector valid 


AL_DEVHLP 0x20 Set if Devhlp alias 
AL_PRIV 0x40 Set if privatized alias 
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Table 52 (Page 2 of 2). al_f Flag Definitions 
AL_VDM 0x80 Set if VDM alias 


AL_NOALIAS 0x100 Set if UVIRT mapping in VDMs 


Table 53. sal_f Flag Definitions 


Name Bit Mask Description 
SAL_CSALIAS AL_CSALIAS 
SAL_MEMMAPALIAS AL_MEMMAP 

should not coincide with other alias types 
SAL_ALIASREFSHIFT 0x6 Low six bits reserved for flags 
SAL_ALIASREFMASK OxOffcO reference count bits mask 


3.4.5 VM Arena Record 


Pointers 
_parvmOne points to the VMAR table. 


VM Owner 
vmar (0xffe3) 


Format 
Field Name Offset Length Type Description 
vmar_reg +0 16 S) Regular Arena Record 
2.4 Size in pages 
2.4 D Virtual page no. 
1.4 Flags 
2 Ww Handle of next Arena 
Record 
ar_harprev 2 WwW Handle of previous Arena 
Record 
ar_harlink 2 Ww Handle of associated Arena 
Record 
ar_harhash 2 Ww Hash table link 
2 WwW Handle of Object Record 
ar_hco 2 Ww Context record handle 
(shar+shr data) 
ar_hobptda +12 2 WwW PTDA handle or NULL (prvar 
or shar + instance data) 
ar_sel +12 2 WwW Selector (sysarena only) 
ar_hal +14 2 Ww Alias record handle, * =0 
means not an alias 
vmar_sen +0 16 S) Sentinel Arena Record 
ar_xf +0 1.4 D Extra flags 
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Field Name as Length Type Description 
2.4 Size in pages 
+4 2.4 D Virtual page no. 
+6.4 1.4 Flags 
ar_harnext +8 2 Ww Handle of next Arena 
Record 
ar_harprev 2 WwW Handle of previous Arena 
Record 
ar_harlink +C 2 Ww Handle of associated Arena 
Record 
ar_harhash 2 Ww Hash table link 
ar_ipgmax 4 D Maximum large no. in the 
arena 
ar_unused 2 WwW reserved 


Table 54. ar_f Flag Definitions 


[Name ita Desoription 


AR_INUSE Record not on free list 


AR_TAG Record type mask 


AR_TAGREG Regular record 


AR_TAGSEN 0x002 Sentinel 


AR_TAGBSEN Boundary sentinel 


AR_SELMAP Memory mapped by selector 


AR_SELBASEALL Base selector map all 


AR_SELMASK Selector map mask 


AR_RELOAD Pre-reserved for huge item or 


AR_WRITE Write permission 


AR_USER User pages 


AR_EXEC 0x080 Executable Pages 


AR_READ Read permission 


AR_HCO Record linked to Context List 


AR_GUARD Guard pages 


AR_SGS 0x800 Registered under Screen Group Switch 


Table 55. ar_xf Flag Definitions 


Name Bit Mask Description 


AR_HCOH context record handle > 64K 
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3.4.6 VM Arena Type Information Record 


Pointers 
VMAH field ah_pat points to the associated VMAT. 


Locations 
_atvm locates the table of VMATs. 


VM Owner 
os2krnl (Oxffaa) 


Format 
Field Name Offset Length Description 
at_laddrInitMin Initial minimum 


at_laddrinitMax +4 Initial maximum 


at_laddrAbsMin +8 Abs minimum boundary 


at_laddrAbsMax +C 


at_cbInitBetween +10 


at_lHashNumbMask +14 


Abs minimum boundary 


Spacer between arenas 


Hash number mask 


at_lIHashNumbShift +18 Hash number shift 


at_lHashNumbAbsMax 


at_lIHashMinSize +20 


at_lbmNumbMask +24 


Max hash table index 


Min hash table size 


+ 
= 
io} 


Bitmap number mask 


at_lbmNumbShift +28 Bitmap number shift 


at_lbmNumbAbsMax +2C 


at_IbdMinSize +30 


at_lbmeNumbMask +34 


Abs Max bitmap # 


Min bitmap dir size 


Bitmap entry # mask 


at_lbmeNumbShift +38 Bitmap entry # shift 


at_lbmeNumbAbsMax +3C Abs Max bitmap entry 


at_lbmeBitNumbShift +44 Bit number shift 
at_fllnit +48 Initial flags 
at_IGran +4c Granularity 


at_laddrMinNoWrap Min no-hash wrap laddr 
at_laddrMaxNoWrap +54 Max no-hash wrap laddr 


SLFISFISIFSSPFPS;S SPS]; S/S;VPSy;U;sy;os;sye;os;syosa|a 
xe] 
@ 


po; R],R LTR] RP] RP RT R] RT RP RT RT RP RP RP RT RRP RP RY] RT RT 


at_harParent +58 Parent arena 


Table 56. at_fllnit Flag Definitions 


Name Bit Mask Description 


VMAT_PRIV_TILED 


VMAT_PRIV_VDM 


VMAT_SYS 3 


VMAT_MAX VMAT_SYS 
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3.4.7 VM Context Record 


Pointers 
_pcovmOne points to the table of VMCOs. 


Locations 
System Arena. 


VM Owner 
vmco (0xffe5) 


Format 
Field Name Offset Length Type Description 
co_hconext +0 2 WwW Index of next Context 
Record 
co_hobptda 2 Ww PTDA handle 
co_fb +4 1 B Context record flags 
Description 
CO_CREATOR originating context 
CO_PRIV Privatized context 
CO_HCOH Next context record handle > 64K 
Write permission 
CO_USER User storage 
CO_EXEC Executable 
CO_READ Read permission 
3.4.8 VM Object Record 
Pointers 
_pobvmOne points to the table of VMOBs. 
Locations 
System Arena. 
VM Owner 
vmob (0xfff1) 
Field Name Type Description 
ob_har Ww Arena Record handle 
ob_hobnext Ww Associated Object Record 
handle 
ob_va D Pseudo-object’s virtual 
address 
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Field Name | offset | Length Type Description 


ob_fs +4 2 Ww Flags 
ob_hobowner +6 2 Ww Owner ID 
ob_hobmte +8 2 Ww MTE handle 

semaphore 
ob_bsemcnt +C 1 B Counter and waiting flag 
ob_cllock +d 1 B Count of all long-term locks 
ob_cslock +e 1 B Count of all short-term locks 

Note: 


A complete list of system owner IDs may be found under VM System 
Object Owner IDs in the Reference Tables section of the System 
Reference. 


Table 58. ob_fs Flag Definitions 


Name Bit Mask Description 
OB_PSEUDO 0x8000 Pseudo-object 


OB_API 0x4000 API allocated object 


OB_LOCKWAIT 0x2000 Some thread to wake in VMUnlock 


OB_LALIAS 0x1000 Object has aliases 


OB_SHARED 0x0800 Object’s contents are shared 


OB_UVIRT 0x0400 UVirt object 


OB_ZEROINIT 0x0200 Object is zero-initialized 


OB_RESIDENT 0x0100 Initial allocation was resident 


OB_LOWMEM 0x0040 Object is in low memory 


OB_GUARD 0x0080 Page attribute/permission flags 


OB_EXEC 0x0020 Executable 


OB_READ 0x0010 Read permission 


OB_USER 0x0008 User Storage 


OB_WRITE 0x0004 Write permission 


OB_HUGE 0x0002 Object is huge 


OB_SHRINKABLE 0x0001 Object is Shrinkable 


OB_DHSETMEM 0x0001 DevHIlp_VMSetMems are allowed 


Table 59. ob_xflags Flag Definitions 


Name Bit Mask Description 


VMOB_SLOCK_WAIT Waiting on short term locks to clear 


VMOB_LLOCK_WAIT Waiting on long term locks to clear 


VMOB_DISC_SEG Object is part of a discardable seg 


VMOB_HIGHMEM Object was allocated via dh_vmalloc 
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3.4.9 Virtual Page Structure 


Pointers 
pf_pvp points to the head of the VP array. 


Locations 
System Arena. 


VM Owner 
pgvp (Oxffb3) 


Format 
avp_s Cc Ss active vp 
vp_frame 2.4 D frame, swp or Idr block # 
vp_flags : 1.4 flags 
2 WwW object relative page number 
vp_hob 2 Ww handle to object record 
vp_refcount 2 WwW virtual page reference count 
vp_semowner 2 Ww Slot number of semaphore 
owner 
a D Free vp 
vp_flink 4 S) forward link 
vp_blink 4 D backward link 
2 Ww pad 
Table 60. vp_flag Flag Definitions 
Name Bit Mask Description 
VP_BUSY 0x001 page semaphore taken 
VP_CACHE search page cache for pf 
VP_PFIDLE cross linked to idle pf 
VP_PF cross linked to pf 
VP_DIRTY contents written to - from pte 
VP_SHDIRTY shadow dirty bit (for VDMs) 
VP_SOW change to swappable on write 
VP_RESIDENT 0x400 cannot be moved - value from pte 
VP_DISCARDABLE 0x800 1 = discardable, 0 = swappable 
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3.5 Scheduler Thread and Process Control Block Reference 
The following control blocks are described in this section: 
3.5.2, “Thread Control Block OS/2 Warp V3.0” on page 98 


3.5.3, “Thread Swappable Data for OS/2 Warp V3.0 ALLSTRICT Kernel” on 
page 121 


3.5.4, “Per-Task Data Area for OS/2 Warp V3.0 ALLSTRICT Kernel” on 
page 125 


3.5.5, “Local Information Segement” on page 147 

3.5.6, “Global Information Segement” on page 148 

3.5.7, “Process Information Block” on page 150 

3.5.8, “Thread Information Block” on page 151 

3.5.9, “System Stack Frames Client Register Information” on page 152 
3.5.10, “Exit List Entry Data Structure” on page 161 

3.5.11, “Exception Handler Structures” on page 161 


An overview of the scheduler control blocks is as follows: 


3.5.1 Scheduler and Task Management Control Block Diagrams 


The following diagrams illustrate the relationships between various scheduler 
and task management control blocks: 


3.5.1.1, “Process Management” on page 90 
“Thread Management” on page 91 
“Scheduler Finite State Machine” on page 92 


“Thread Tree for a Process” on page 93 


“Orphaned and Adopted Processes” on page 95 


2, 
.3, 
4, 

3.5.1.5, “Process Trees, Subtrees and Zombies” on page 94 
6, 
.7, “OS/2 Exception Management - Overview” on page 96 
8, 


“Exception Handler Stack Frames” on page 97 
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3.5.1.1 Process Management 
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Figure 20. Process Management 
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3.5.1.2 Thread Management 
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Figure 21. Thread Management 
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3.5.1.3 Scheduler Finite State Machine 
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Figure 22. Scheduler Finite State Machine 
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3.5.1.4 Thread Tree for a Process 


Thread Tree for a Process 
PTDA 
+20 TCB TSD 
—> 
Thread 1 
ptda_pTCBCritSec +14 
| 
el 
TCB TSD 
— 
Thread 2 
4158 
a 
TCB TSD 
{_______s L___s 
=> 
Thread 3 
— 
TCB TSD 
=> 
Thread 4 
+15¢c 
<< 


Thread 3 is in critical section 


Thread 2 and Thread 1 are waiting for Thread 4 to die 


RJM 28th Aug 95 - thdtree 


Figure 23. Thread Tree for a Process 
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3.5.1.5 Process Trees, Subtrees and Zombies 


The Process Tree, Subtrees and Zombies 
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ptda_ulExitcode [T | 


ptda_ulExitType [J 
ptda_ulExitTID =a 
| 


Pid 10 
Pid 11 
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Pids 1 — 7 are active 

Pids 8 — 11 are dead (zombies) 
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Pid 5 may DosWaitChild on Pid 11 RUM 26th Aug 95 - priree 


Figure 24. Process Trees, Subtrees and Zombies 
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3.5.1.6 Orphaned and Adopted Processes 


Orphaned and Adopted Processes 


Pid 2 dies 


RJM 28th Aug 95 - prorphan 


Figure 25. Orphaned and Adopted Processes 
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3.5.1.7 OS/2 Exception Management - Overview 


Exception Handling - Overview 
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Figure 26. Exception Management Overview 
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3.5.1.8 Exception Handler Stack Frames 


Exception Handler Stack Frames 
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Figure 27. Exception Handler Stack Frames 
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3.5.2 Thread Control Block OS/2 Warp V3.0 


For TCB formats for other versions of OS/2 see: 
3.5.2.1, “Thread Control Block for OS/2 Warp V3.0 with FixPak” on page 105 


3.5.2.2, “Thread Control Block for OS/2 Warp V3.0 with FixPak 11 or Later” on 
page 109 


3.5.2.3, “Thread Control Block for OS/2 V2.11 with FixPak 90 or Later” on 
page 113 


3.5.2.4, “Thread Control Block for OS/2 V2.11” on page 117 


Pointers 
_papTCBSlots points to the thread slot table of TCB pointers. 


Multiple chain pointers between, TSD, TCB and PTDA. 
CurrTCB points to the current TCB. 


Locations 
System Arena. 


VM Owner 
tcb (Oxffcc) 


Format 
Field Name Offset Length Type Description 
TCBOrdinal +0 2 WwW Ordinal number of thread in 
PTDA 
TCBNumber +2 2 WwW Thread slot number 
4 D Bit vector of forced actions 
TCBpPTDA +8 4 D Pointer to the PTDA 
TCBpTSD +C 4 D Pointer to thread swappable 


data 


aN 


TCBptib +10 Pointer to thread info block 


D 
TCBpTCBNext +14 D forward link to next (active) 
TCB 
D 


TCBcbStackMax Virtual size of stack object 


iN 


iN 


TCBcbStackCur 4 Committed size of stack 
object 
TCBpStack 4 D Virtual base of stack 
4 D Virtual base of 16-bit stack 
TCBpStack16Hi 4 D Virtual limit of 16-bit stack 
TCBpLibiHead 4 D Link to libi load data area 
TCBpLibiCurr 4 D Link to libi load data area 
4 D Link to libi free data area 
TCB_pcriFrameType +38 4 D stack frame type 
TCB_pFrameBase +3C 4 D stack frame base pointer 
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Field Name | Offset | Length Type Description 

TCB_hookheadLocal +40 8 D local context hook head 

TCB_phookOwnerHead +48 4 D linked list of hook blocks 

TCBpteKStackTCBO +4¢ 4 D KStack page 0 of TCB 

TCBpteKStackTCB1 4 D KStack page 1 of TCB 

TCBpteKStackTSD +54 4 D KStack TSD page 

TCBpteKStackPTDAO +58 4 D KStack page 0 of PTDA 

TCBpteKStackPTDA1 +5C 4 D KStack page 1 of PTDA 

TCBpteKStackPTDA2 4 D KStack page 2 of PTDA 

TCBCurrTCB 4 D SS-relative offset of Current 
TCB 

TCBCurrTSD 4 D SS-relative offset of Current 
TSD 

TCBBiasTCB 4 D stack-to-flat TCB conversion 
value 

TCBBiasTSD +70 4 D stack-to-flat TSD conversion 
value 

TCBTLMA +74 80 Thread local memory area 

TCBDMAAdd +f4 4 User’s I/O transfer address 

TCBSecPos +8 4 Position of first sector 
accessed within file 

TCBThisSFT tfc 4 D pointer to SFT we’re 
working with 

TCBValSec +100 4 D Number of valid (previously 
written) sectors 

TCBpRTCB +104 4 D Redirector TCB (Used by 
LANMAN) 

TCBProc_ID +108 2 WwW process ID for file sharing 
checks 

TCBUser_ID +10a 2 Ww user ID for file sharing 
checks 

TCBfSharing +10c 1 B non-zero ==> no 
redirection 

TCBSrvAttrib +10d 1 B see SetAttrib/file.asm 

TCBJfnFlag +10e 1 B JFN flag bits for current file 
handle 

TCBAllowed +10f 1 B Allowed | 24 answers (see 
allowed_) 

TCBOpCookie +110 4 D server’s per file cookie 

TCBOpFlags +114 2 Ww whether server wants 
oplock, etc. 

TCBCurBuf +116 4 D currently assigned buffer 

TCBThishVPB 2 Ww handle of current VPB 

TCBNextAdd +11¢c 2 Ww 

TCBBytSecPos +11e 2 WwW position of first byte within 
sector 

TCBClusNum +120 2 WwW 
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TCBLastPos 2 WwW 
TCBBytCnt1 2 WwW Number of bytes in 1st 
sector 
TCBBytCnt2 2 WwW # of bytes in last sector 
2 WwW number of whole sectors 
TCBSecClusPos 1 B posit of first sector within 
cluster 
TCBBufHE 1 B How to handle a HardError 
TCBactBufHE 1 action response from user 
on HardErr 
1 B NZ if TCBLockHndl is valid 
TCBLockHndl Cc iS) Lock handle of user mem 
TCBThisCDS 4 D Address of current CDS 
TCBThisFSC 4 D address of current FSC 
TCBpOpenBuf 2 Ww Address of current OpenBuf 
TCBpSearchBuf 2 WwW Address of SearchBuf 
TCBFailErr 2 WwW NZ if user did FAIL on | 24 
4 D 16-bit addr of the ramsem 
blocked upon 
TCB_SemDebugAddr 4 D debugger display address 
for ksems 
TCB_NPX_Buffer 4 D 
TCBpTCBWaitNext 4 Next waiting TCB 
4 D Threads waiting for me to 
die 
TCBQState 1 B Scheduler queue location 
(actual) 
TCBState 1 B Current scheduler state 
(desired) 
TCBWakeFlags 1 B TKSleep/TKWakeup Flags 
TCBPriClass 1 B Priority Class (user) 
TCBPriLevel 1 B Priority Level (user) 
TCBPriClassMod 1 B Priority Class modifier bits 
1 : Misc. Scheduler flags 
TCBPriority 2 WwW Calculated Priority 
TCBPriorityMin 2 Ww Minimum Scheduling priority 
TCBcBoostLock 4 D Kernel Boost Lock nesting 
count. 
4 D Next priority queue in chain 
TCBpTCBPriPrevQ +174 4 Previous priority queue in 
chain 
TCBpTCBPriHigher +178 4 D Higher priority thread 


100 os/2 Debugging 


Field Name | Offset | Length Type Description 

TCBpTCBPriLower +17c 4 D Lower priority thread 

TCBpTCBPriNext +180 4 D Next same-priority thread 

TCBpTCBPriPrev +184 4 D Prev same-priority thread 

TCBpTCBWakeup 4 D TKQueryWakeup TCB list 

TCBSleepID +18c 4 D Sleep ID this TCB is 
sleeping on 

TCBtoe +190 10 iS) Timeout/Starvation Timeout 
element 

TCBCheckedSig +1a0 1 B Used by the loader 

TCBfSwapping 1 B status of swapping 

TCBVollONest +1a2 1 B nesting level of 
FSH_DoVollO 

TCBRegPktFlg +1a3 1 B Flag to indicate if request 
pkt in use 

TCBReqPkt +1a4 4 D 1/O request packet for 
thread 

TCBSysTime 4 time spent in system code 

TCBUserTime +1ac 4 time spent in user code 

TCB_pPVDBThd +1b0 4 Ptr to Perfview Data Block 
for this thread (pvdb_thd_s). 

TCB_flDbg +1b4 4 D 

TCBCpl2_ESP +1b8 4 Saved TSS CPL2 stack 
pointer. 

TCBCpl2_SS +1bc 2 WwW Saved TSS CPL2 stack 
segment. 

TCBNewFlags +ibe 1 B Value copied from 
ptda_NewFiles 

TCBEntryActions +1bf 1 B Kernel entry force flags 

TCBSig_pend 2 Ww bit vector of pending signals 

TCBSig_holding +1c2 2 Ww bit vector of postponed 
signals 

TCBSig_cur +1c4 2 WwW bit vec of signals being 
processed 

TCBXcptRepRec +1c6 4 D report record of active 
exception 

TCBSig_termtid 2 w tid of terminator -75797 

TCBSecbits +1cc 1 B Security bits 54735 

TCBspbytes +1cd 1 B To keep size 4*N 54735 

TCB_ulSRIndex +ice 4 D Last semaphore cleared in 
MUX 72485 

TCBMiscFlags +1d2 1 B Used for hard error 
processing 

TCBModeFlags +1d3 2 WwW Mode flags for OPEN - for 
WhatVolume 

TCBSpareFlags +1d5 1 B Spare flags 

TCBLibiFlags +1d6 1 B 84537 
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TCBFiller +1d7 1 B To keep size 4*N 
TCB_ProcNameBuf +1d8 4 D Pointer to procedure name 
TCB_ObjNameBuf +1dc 4 D Pointer to object name 
buffer 
4 D aka TCB_TgtModNameBui 
TCB_SrcModNameBuf +1e4 4 D Used by loader 
TCB_FaultBuf +1e8 4 D 
TCB_ObjNameBufL +1ec 2 Ww Length of object name 
buffer 
[Toe TmeNamebut ——_—~ip vee —~+d w 
TCB_SrcModNameBufL +1f0 2 Ww 
TCB_FaultBufL +1f2 2 Ww 
TCBSecchild +14 4 D Child Security data 54735 
Table 61. TCBForcedActions Flag Definitions 
Name Bit Mask Description 


TK_FF_EXIT 0x00000002 Call TKExit (old FF_DES) 
TK_FF_CRITSEC 0x00000004 Enter Per-task critical section 


TK_FF_ICE 0x00000008 Freeze thread 


TK_FF_NPX 0x00000010 NPX Error 


TK_FF_TIB 0x00000020 Update the TIB 
TK_FF_TRC 0x00000040 Enter Debug 


TK_FF_SIG 0x00000080 Signal pending 


TK_FF_CTXH 0x00000100 Pending local context hooks 


TK_FF_STIH 0x00000200 Execute STI hooks 
TK_FF_VDMBP 0x00000400 Execute VDM BP hooks 


TK_FF_RTRY 0x00000800 Retry V86 system call 


TK_FF_PIB 0x00001000 Update the PIB 


TK_FF_SCH 0x00002000 Do Scheduler Processing 
TK_FF_TFBIT 0x00004000 Validate user eflags TF bit 


TK_FF_TIBPRI 0x00008000 Update only the priority fields in TIB 59463 


Table 62. TCBEntryActions Flag Definitions 


Bit Mask 


Name Description 


TK_EF_PFCLI 1 


Page fault inside CLI 


DosDebug action pending 
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Table 63. TCBWakeFlags Flag Definitions 


Name 


Bit Mask 


Description 


TK_WF_INTERRUPTED 


0x01 


Sleep was interrupted 


TK_WF_TIMEEXP 


TK_WF_SINGLEWAKEUP 


0x02 


Timeout expired 
Interrupt pending 


Thread wants single wakeup 


TK_WF_INTERRUPTIBLE 


Thread blocked interruptibly 


TK_WF_TIMEOUT 


Thread blocked with timeout 


In TKSleep() 


Table 64. TCBState and TCBQState Definitions 


Name 


STATE_READY 


Value 


Description 
Uninitialized 


Ready to run 


STATE_BLOCKED 


Blocked on an ID 


STATE_SUSPENDED 


STATE_CRITSEC 


STATE_RUNNING 


Suspended (DosSuspendThread) 
Blocked by another CritSec thread 


Thread currently running 


STATE_READYBOOST 


Ready, but apply an IO boost 


STATE_TSD 


STATE_DELAYED 


STATE_FROZEN 


Thread waiting for TSD 
Delayed TKWakeup (Almost Ready) 
Frozen Thread (FF_ICE) 


STATE_GETSTACK 


Incoming TSD 


STATE_BADSTACK 


Table 65. TCBPriClassMod Definitions 


TSD failed to swap in 


Name 


Description 


CLASSMOD_KEYBOARD 


CLASSMOD_DEVICE 


Keyboard boost 
Starvation boost 


Device I/O Done Boost 


CLASSMOD_FOREGROUND 


Foreground boost 


CLASSMOD_WINDOW 


CLASSMOD_VDM_INTERRUPT 


Window Boost 


VDM simulated interrupt boost 


Table 66 (Page 1 of 2). TCBPriClass Definitions 


Name 


CLASS_IDLE_TIME 


Value 


Description 
No priority class change 


Idle-Time class 


CLASS_REGULAR 


Regular class 


CLASS_TIME_CRITICAL 


Time-Critical class 
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Table 66 (Page 2 of 2). TCBPriClass Definitions 
Name Value Description 


CLASS_SERVER 0x04 Client/Server Server class 


Table 67. TCBSchFlg Flag Definitions 


Name Bit Mask Description 
SCH_PROTECTED_PRI 0x0001 Only Intra-process SetPri allowed 
SCH_WINDOWBOOST_LOCK 0x0002 Lock out windoboost changes 
SCH_PAGE_FAULT 0x0008 Dynamic timeslicing ### 
SCH_PAGE_FAULT_BIT 0x03 Dynamic timeslicing P728371 


Table 68. TCBfSwapping Flag Definitions 
Name Bit Mask Description 


SM_TCB_SWAPPING 0x01 swap I/O underway 


SM_TCB_RESIZING 0x02 data structures are growing 


Table 69. TCBMiscFlags Flag Definitions 


Name Bit Mask Description 


TMF_CMapFailed Set if alloc/realloc failed on a cluster 
map (mft_selCMap). 


If set, ignore (auto fail) hard error 
TMF_MULT_XCPT Set if multiple ring 0 exceptions 
TMF_NoFwd Set if inhibiting forwarders 


TMF_EXIT_TERM TK_FF_EXIT means TKTermThread 


Indicates TIB exception field invalid 


Indicates an exception harderr is pending 


Description 


Foreground Disk I/O 


SPFLAGS_FGND_DISKIO 0x0080 


Table 71. TCBReqPKktFlig Flag Definitions 
Name Bit Mask Description 


TK_RP_ALLOCATED 0x01 


TK_RP_INUSE 0x02 
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3.5.2.1. Thread Control Block for OS/2 Warp V3.0 with FixPak 
See FixPak 09 for details of the changes introduced in this FixPak. 


TCBOrdinal 2 WwW Ordinal number of thread in 
PTDA 
TCBNumber 2 WwW Thread slot number 
TCBForcedActions 4 D Bit vector of forced actions 
4 D Pointer to the PTDA 
TCBpTSD 4 D Pointer to thread swappable 
data 
TCBptib 4 Pointer to thread info block 
TCBpTCBNext 4 forward link to next (active) 
TCB 
4 Virtual size of stack object 
TCBcbStackCur 4 Committed size of stack 
object 
TCBpStack 4 D Virtual base of stack 
TCBpStack16Lo 4 D Virtual base of 16-bit stack 
4 D Virtual limit of 16-bit stack 
TCBpLibiHead 4 D Link to libi load data area 
TCBpLibiCurr 4 D Link to libi load data area 
TCBpLibiFree 4 D Link to libi free data area 
4 D stack frame type 
TCB_pFrameBase 4 D stack frame base pointer 
TCB_hookheadLocal 8 D local context hook head 
TCB_phookOwnerHead 4 D linked list of hook blocks 
4 D KStack page 0 of TCB 
TCBpteKStackTCB1 4 D KStack page 1 of TCB 
TCBpteKStackTSD 4 D KStack TSD page 
TCBpteKStackPTDAO 4 D KStack page 0 of PTDA 
4 D KStack page 1 of PTDA 
TCBpteKStackPTDA2 4 D KStack page 2 of PTDA 
TCBCurrTCB 4 D SS-relative offset of Current 
TCB 
TCBCurrTSD 4 D SS-relative offset of Current 
TSD 
4 D stack-to-flat TCB conversion 
value 
TCBBiasTSD 4 D stack-to-flat TSD conversion 
value 
TCBpDHRetAdadr +74 4 D 82818 Pointer to DHRouter 
return address 
TCBTLMA +78 80 D Thread local memory area 
4 D User’s I/O transfer address 
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Field Name | Offset | Length Type Description 

TCBSecPos +fe 4 D Position of first sector 
accessed within file 

TCBThisSFT +100 4 D pointer to SFT we’re 
working with 

TCBValSec +104 4 D Number of valid (previously 
written) sectors 

TCBpRTCB +108 4 D Redirector TCB (Used by 
LANMAN) 

TCBProc_ID 2 WwW process ID for file sharing 
checks 

TCBUser_ID 2 Ww user ID for file sharing 
checks 

TCBfSharing 1 B non-zero ==> no 
redirection 

TCBSrvAttrib 1 B see SetAttrib/file.asm 

TCBuJfnFlag 1 B JFN flag bits for current fil 
handle 

TCBAllowed 1 B Allowed | 24 answers (see 
allowed_) 

TCBOpCookie 4 server’s per file cookie 

TCBOpFlags +118 2 Ww whether server wants 
oplock, etc. 

TCBCurBuf 4 D currently assigned buffer 

TCBThishVPB 2 Ww handle of current VPB 

TCBNextAdd 2 Ww 

TCBBytSecPos +122 2 WwW position of first byte within 
sector 

TCBClusNum 2 WwW 

TCBLastPos 2 WwW 

TCBBytCnt1 2 WwW Number of bytes in 1st 
sector 

TCBBytCnt2 2 WwW # of bytes in last sector 

TCBSecCnt 2 W number of whole sectors 

TCBSecClusPos 1 B posit of first sector within 
cluster 

TCBBufHE 1 B How to handle a HardError 

TCBactBufHE +130 1 action response from user 
on HardErr 

TCBflOLock 1 B NZ if TCBLockHndl is valid 

TCBLockHndl Cc Ss Lock handle of user mem 

TCBThisCDS 4 D Address of current CDS 

TCBThisFSC 4 D address of current FSC 

TCBpTmpCDS 4 D Address of dummycds 

TCBpOpenBuf 2 WwW Address of current OpenBuf 

TCBpSearchBuf 2 WwW Address of SearchBuf 
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Field Name | Offset | Length Type Description 

TCBFailErr +14e 2 Ww NZ if user did FAIL on | 24 

TCB_SemInfo +150 4 D 16bit addr of the ramsem 
blocked upon 

TCB_SemDebugAddr +154 4 D debugger display address 
for ksems 

TCB_NPX_Buffer 4 D 

TCBpTCBWaitNext +15c 4 Next waiting TCB 

TCBpTCBWaitList +160 4 Threads waiting for me to 
die 

TCBQState +164 1 B Scheduler queue location 
(actual) 

TCBState +165 1 B Current scheduler state 
(desired) 

TCBWakeFlags +166 1 B TKSleep/TKWakeup Flags 

TCBcWindowBoost +167 1 B Window Boost count 

TCBPriClass +168 1 B Priority Class (user) 

TCBPriLevel 1 B Priority Level (user) 

TCBPriClassMod +16a 1 B Priority Class modifier bits 

TCBSchFlags +16b 1 B Misc. Scheduler flags 

TCBPriority +16c 2 WwW Calculated Priority 

TCBPriorityMin 2 WwW Minimum Scheduling priority 

TCBcBoostLock +170 4 D Kernel Boost Lock nesting 
count. 

TCBpTCBPriNextQ +174 4 D Next priority queue in chain 

TCBpTCBPriPrevQ +178 4 D Previous priority queue in 
chain 

TCBpTCBPriHigher 4 D Higher priority thread 

TCBpTCBPriLower +180 4 D Lower priority thread 

TCBpTCBPriNext +184 4 D Next same-priority thread 

TCBpTCBPriPrev +188 4 D Prev same-priority thread 

TCBpTCBWakeup 4 D TKQueryWakeup TCB list 

TCBSleepID +190 4 D Sleep ID this TCB is 
sleeping on 

TCBtoe +194 10 iS) Timeout/Starvation Timeout 
element 

TCBCheckedSig +1a4 1 B Used by the loader 

TCBfSwapping 1 B status of swapping 

TCBVollONest +1a6 1 B nesting level of 
FSH_DoVollO 

TCBRegPktFlg +1a7 1 B Flag to indicate if request 
pkt in use 

TCBReqPkt +1a8 4 D 1/O request packet for 
thread 

TCBSysTime 4 time spent in system code 

TCBUserTime +1b0 4 D time spent in user code 
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Field Name | Offset | Length Type Description 

TCB_pPVDBThd 4 D Ptr to Perfview Data Block 
for this thread (pvdb_thd_s). 

TCB_flDbg 4 D 

TCBCpl2_ESP 4 Saved TSS CPL2 stack 
pointer. 

TCBCpl2_SS +1c0 2 WwW Saved TSS CPL2 stack 
segment. 

TCBNewFlags 1 B Value copied from 
ptda_NewFiles 

TCBEntryActions 1 B Kernel entry force flags 

TCBSig_pend 2 WwW bit vector of pending signals 

TCBSig_holding +1c6 2 Ww bit vector of postponed 
signals 

TCBSig_cur 2 WwW bit vec of signals being 
processed 

TCBXcptRepRec 4 D report record of active 
exception 

TCBSig_termtid 2 Ww tid of terminator -75797 

TCBSecbits 1 B Security bits 54735 

TCBspbytes 1 B To keep size 4*N 54735 

TCB_ulSRIndex 4 D Last semaphore cleared in 
MUX 72485 

TCBMiscFlags 1 B Used for hard error 
processing 

TCBModeFlags +1d7 2 WwW Mode flags for OPEN - for 
WhatVolume 

TCBSpareFlags 1 B Spare flags 

TCBLibiFlags 1 B 84537 

TCBFiller 1 B To keep size 4*N 

TCB_ProcNameBuf 4 D Pointer to procedure name 

TCB_ObjNameBuf 4 D Pointer to object name 
buffer 

TCB_TmpNameBuf 4 D aka TCB_TgtModNameBuf 

TCB_SrcModNameBuf 4 D Used by loader 

TCB_FaultBuf 4 D 

TCB_ObjNameBufL 2 Ww Length of object name 
buffer 

TCB_TmpNameBufL 2 WwW 

TCB_SrcModNameBufL 2 Ww 

TCB_FaultBufL 2 W 

TCBSecchild +118 4 D Child Security data 54735 
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Table 72. TCBLibiFlags Flag Definitions 
Name Bit Mask Description 


INIT_ROUTINE_FAILED (0x01) 84537 Set if dll init routine failed 


3.5.2.2 Thread Control Block for OS/2 Warp V3.0 with FixPak 11 or 


Later 
Field Name Offset Length Type Description 
TCBOrdinal +0 2 WwW Ordinal number of thread in 
PTDA 
TCBForcedActions +4 4 D Bit vector of forced actions 
TCBpPTDA +8 4 D Pointer to the PTDA 
TCBpTSD +C 4 D Pointer to thread swappable 


data 


4 D Pointer to thread info block 
TCBpTCBNext +14 4 forward link to next (active) 
TCB 
TCBcbStackMax +18 4 Virtual size of stack object 
TCBcbStackCur 4 D Committed size of stack 


object 


+ 
= 
io} 


+20 4 D Virtual base of stack 
TCBpStack16Lo +24 4 D Virtual base of 16-bit stack 
TCBpStack16Hi +28 4 D Virtual limit of 16-bit stack 
TCBpLibiHead +2C 4 D Link to libi load data area 

4 D Link to libi load data area 
TCBpLibiFree +34 4 D Link to libi free data area 
TCB_pcriFrameType +38 4 D stack frame type 
TCB_pFrameBase +3C 4 D stack frame base pointer 

8 D local context hook head 
TCB_phookOwnerHead +48 4 D linked list of hook blocks 
TCBpteKStackTCBO +4c¢ 4 D KStack page 0 of TCB 
TCBpteKStackTCB1 +50 4 D KStack page 1 of TCB 
TCBpteKStackPTDAO +58 4 D KStack page 0 of PTDA 
TCBpteKStackPTDA1 +5C 4 D KStack page 1 of PTDA 
TCBpteKStackPTDA2 +60 4 D KStack page 2 of PTDA 

4 D SS-relative offset of Current 

TCB 
TCBCurrTSD +68 4 D SS-relative offset of Current 
TSD 

TCBBiasTCB +6C 4 D stack-to-flat TCB conversion 


value 
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Field Name | offset | Length Type Description 

TCBBiasTSD 4 D stack-to-flat TSD conversion 
value 

TCBpDHRetAddr 4 D 82818 Pointer to DHRouter 
return address 

TCBTLMA 80 D Thread local memory area 

TCBDMAAdd 4 User’s I/O transfer address 

TCBSecPos +fc 4 Position of first sector 
accessed within file 

TCBThisSFT +100 4 D pointer to SFT we’re 
working with 

TCBValSec +104 4 D Number of valid (previously 
written) sectors 

TCBpRTCB +108 4 D Redirector TCB (Used by 
LANMAN) 

TCBProc_ID 2 WwW process ID for file sharing 
checks 

TCBUser_ID 2 Ww user ID for file sharing 
checks 

TCBfSharing 1 B non-zero ==> no 
redirection 

TCBSrvAttrib 1 B see SetAttrib/file.asm 

TCBuJfnFlag 1 B JFN flag bits for current fil 
handle 

TCBAllowed 1 B Allowed | 24 answers (see 
allowed_) 

TCBOpCookie 4 D server’s per file cookie 

TCBOpFlags +118 2 WwW whether server wants 
oplock, etc. 

TCBCurBuf 4 D currently assigned buffer 

TCBThishVPB 2 Ww handle of current VPB 

TCBNextAdd 2 Ww 

TCBBytSecPos +122 2 Ww position of first byte within 
sector 

TCBClusNum 2 WwW 

TCBLastPos 2 Ww 

TCBBytCnt1 2 WwW Number of bytes in 1st 
sector 

TCBBytCnt2 2 WwW # of bytes in last sector 

TCBSecCnt 2 WwW number of whole sectors 

TCBSecClusPos 1 B posit of first sector within 
cluster 

TCBBufHE 1 B How to handle a HardError 

TCBactBufHE +130 1 B action response from user 
on HardErr 

TCBflOLock +131 1 NZ if TCBLockHndl is valid 

TCBLockHndl +132 Cc Ss Lock handle of user mem 
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TCBThisCDS +13e 4 Address of current CDS 
TCBThisFSC +142 4 D address of current FSC 
TCBpTmpCDS +146 4 D Address of dummycds 
2 WwW Address of current OpenBuf 
TCBpSearchBuf +14c 2 WwW Address of SearchBuf 
TCBFailErr +14e 2 WwW NZ if user did FAIL on | 24 
TCB_SemInfo +150 4 D 16bit addr of the ramsem 
blocked upon 
4 D debugger display address 
for ksems 
TCB_NPX_Buffer +158 4 
TCBpTCBWaitNext +15c 4 Next waiting TCB 
TCBpTCBWaitList +160 4 D Threads waiting for me to 
die 
1 B Scheduler queue location 
(actual) 
TCBState +165 1 B Current scheduler state 
(desired) 
TCBWakeFlags +166 1 B TKSleep/TKWakeup Flags 
TCBcWindowBoost +167 1 B Window Boost count 
TCBPriLevel +169 1 B Priority Level (user) 
TCBPriClassMod +16a 1 B Priority Class modifier bits 
TCBSchFlags +16b 1 B Misc. Scheduler flags 
2 Ww Calculated Priority 
TCBPriorityMin +16e 2 WwW Minimum Scheduling priority 
TCBcBoostLock +170 4 D Kernel Boost Lock nesting 
count. 
TCBpTCBPriNextQ +174 4 Next priority queue in chain 
4 D Previous priority queue in 
chain 
TCBpTCBPriHigher +17c 4 D Higher priority thread 
TCBpTCBPriLower +180 4 D Lower priority thread 
TCBpTCBPriNext +184 4 D Next same-priority thread 
4 D Prev same-priority thread 
TCBpTCBWakeup +18c 4 D TKQueryWakeup TCB list 
TCBSleepID +190 4 D Sleep ID this TCB is 
sleeping on 
TCBtoe +194 14 S) Timeout/Starvation Timeout 
element 
TCBfSwapping +1a9 1 B status of swapping 
TCBVollONest t+iaa 1 B nesting level of 


FSH_DoVollO 
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Field Name | Offset | Length Type Description 

TCBRegPktFlg 1 B Flag to indicate if request 
pkt in use 

TCBReqPkt 4 D I/O request packet for 
thread 

TCBSysTime 4 D time spent in system code 

TCBUserTime 4 time spent in user code 

TCB_pPVDBThd 4 Ptr to Perfview Data Block 
for this thread (pvdb_thd_s). 

TCB_flDbg 4 D 

TCBCpl2_ESP 4 D Saved TSS CPL2 stack 
pointer. 

TCBCpl2_SS +1c4 2 W Saved TSS CPL2 stack 
segment. 

TCBNewFlags 1 B Value copied from 
ptda_NewFiles 

TCBEntryActions 1 B Kernel entry force flags 

TCBSig_pend 2 Ww bit vector of pending signals 

TCBSig_holding +1ca 2 Ww bit vector of postponed 
signals 

TCBSig_cur 2 WwW bit vec of signals being 
processed 

TCBXcptRepRec 4 D report record of active 
exception 

TCBSig_termtid 2 Ww tid of terminator -75797 

TCBSecbits 1 B Security bits 54735 

TCBspbytes 1 B To keep size 4*N 54735 

TCB_ulSRIndex 4 D Last semaphore cleared in 
MUX 72485 

TCBMiscFlags 1 B Used for hard error 
processing 

TCBModeFlags +idb 2 WwW Mode flags for OPEN - for 
WhatVolume 

TCBSpareFlags 1 B Spare flags 

TCBLibiFlags 1 B 84537 

TCBFiller 1 B To keep size 4*N 

TCB_ProcNameBuf 4 D Pointer to procedure name 

TCB_ObjNameBuf 4 D Pointer to object name 
buffer 

TCB_TmpNameBuf 4 D aka TCB_TgtModNameBuf 

TCB_SrcModNameBuf 4 D Used by loader 

TCB_FaultBuf 4 D 

TCB_ObjNameBufL 2 Ww Length of object name 
buffer 

TCB_TmpNameBufL 2 WwW 

TCB_SrcModNameBufL 2 Ww 
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Field Name Type Description 
TCB_FaultBufL +1fa 2 WwW 
TCBSecchild +1fc 4 D Child Security data 54735 
3.5.2.3 Thread Control Block for OS/2 V2.11 with FixPak 90 or Later 
Feature 82818 introduces the Kernel Debugger .MK command. 82818 is supplied 
as an APAR fix to: 
OS/2 Warp V3.0 as PJ18364 in FixPak 7. 
OS/2 V2.11 as PJ16805 in FixPak 90. 
Field Name Offset Length Type Description 
2 WwW Ordinal number of thread in 
PTDA 
TCBNumber +2 2 WwW Thread slot number 
TCBForcedActions +4 4 D Bit vector of forced actions 
TCBpPTDA +8 4 D Pointer to the PTDA 
4 D Pointer to thread swappable 
data 
TCBptib 4 Pointer to thread info block 
TCBpTCBNext 4 forward link to next (active) 
TCB 
TCBcbStackMax 4 Virtual size of stack object 
4 Committed size of stack 
object 
TCBpStack 4 D Virtual base of stack 
TCBpStack16Lo 4 D Virtual base of 16-bit stack 
TCBpStack16Hi 4 D Virtual limit of 16-bit stack 
4 D Link to libi load data area 
TCBpLibiCurr 4 D Link to libi load data area 
TCBpLibiFree 4 D Link to libi free data area 
TCB_pcriFrameType 4 D stack frame type 
4 D stack frame base pointer 
TCB_hookheadLocal 8 D local context hook head 
TCB_phookOwnerHead 4 D linked list of hook blocks 
TCBpteKStackTCBO 4 D KStack page 0 of TCB 
4 D KStack page 1 of TCB 
TCBpteKStackTSD 4 D KStack TSD page 
TCBpteKStackPTDAO 4 D KStack page 0 of PTDA 
TCBpteKStackPTDA1 4 D KStack page 1 of PTDA 
TCBCurrTCB +64 4 D SS-relative offset of Current 
TCB 
TCBCurrTSD +68 4 D SS-relative offset of Current 
TSD 
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Field Name | Offset | Length Type Description 

TCBBiasTCB 4 D stack-to-flat TCB conversion 
value 

TCBBiasTSD 4 D stack-to-flat TSD conversion 
value 

TCBpDHRetAddr 4 D 82818 Pointer to DHRouter 
return address 

TCBDMAAdd 4 D User’s I/O transfer address 

TCBSecPos 4 Position of first sector 
accessed within file 

TCBThisSFT 4 D pointer to SFT we’re 
working with 

TCBValSec 4 D Number of valid (previously 
written) sectors 

TCBpRTCB +88 4 D Redirector TCB (Used by 
LANMAN) 

TCBProc_ID +8C 2 WwW process ID for file sharing 
checks 

TCBUser_ID +8e 2 Ww user ID for file sharing 
checks 

TCBfSharing +90 1 B non-zero ==> no 
redirection 

TCBSrvAttrib 1 B see SetAttrib/file.asm 

TCBJfnFlag +92 1 B JFN flag bits for current fil 
handle 

TCBAllowed +93 1 B Allowed | 24 answers (see 
allowed_) 

TCBOpCookie +94 4 D server’s per file cookie 

TCBOpFlags +98 2 Ww whether server wants 
oplock, etc. 

TCBCurBuf +9a 4 D currently assigned buffer 

TCBThishVPB +9e 2 Ww handle of current VPB 

TCBNextAdd +a0 2 WwW 

TCBBytSecPos +a2 2 WwW position of first byte within 
sector 

TCBClusNum +a4 2 Ww 

TCBLastPos +a6 2 WwW 

TCBBytCnt1 +a8 2 WwW Number of bytes in ist 
sector 

TCBBytCnt2 +aa 2 WwW # of bytes in last sector 

TCBSecCnt +ac 2 W number of whole sectors 

TCBSecClusPos +ae 1 B posit of first sector within 
cluster 

TCBBufHE taf 1 B How to handle a HardError 

TCBactBufHE +b0 1 B action response from user 
on HardErr 

TCBflOLock +b1 1 B NZ if TCBLockHndl is valid 
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TCBLockHndl +b2 Cc iS) Lock handle of user mem 
TCBThisCDS +be 4 D Address of current CDS 
TCBThisFSC +c2 4 D address of current FSC 
TCBpOpenBuf +ca 2 Ww Address of current OpenBuf 
TCBpSearchBuf +CC 2 WwW Address of SearchBuf 
TCBFailErr +ce 2 WwW NZ if user did FAIL on | 24 
4 D 16bit addr of the ramsem 
blocked upon 
TCB_SemDebugAddr 4 D debugger display address 
for ksems 
TCB_NPX_Buffer 4 
TCBpTCBWaitNext 4 D Next waiting TCB 
4 D Threads waiting for me to 
die 
TCBQState 1 B Scheduler queue location 
(actual) 
TCBState 1 B Current scheduler state 
(desired) 
TCBWakeFlags 1 B TKSleep/TKWakeup Flags 
TCBPriClass 1 B Priority Class (user) 
TCBPriLevel 1 B Priority Level (user) 
TCBPriClassMod 1 B Priority Class modifier bits 
1 : Misc. Scheduler flags 
TCBPriority 2 Ww Calculated Priority 
TCBPriorityMin 2 Ww Minimum Scheduling priority 
TCBcBoostLock 4 D Kernel Boost Lock nesting 
count. 
4 Next priority queue in chain 
TCBpTCBPriPrevQ +f8 4 Previous priority queue in 
chain 
TCBpTCBPriHigher t+fc 4 D Higher priority thread 
TCBpTCBPriLower +100 4 D Lower priority thread 
4 D Next same-priority thread 
TCBpTCBPriPrev 4 D Prev same-priority thread 
TCBpTCBWakeup 4 D TKQueryWakeup TCB list 
TCBSleepID 4 D Sleep ID this TCB is 
sleeping on 
14 iS) Timeout/Starvation Timeout 
element 
TCBCheckedSig +128 1 B Used by the loader 
TCBfSwapping +129 1 B status of swapping 
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Field Name | Offset | Length Type Description 

TCBVollONest +12a 1 B nesting level of 
FSH_DoVollO 

TCBRegPktFlg +12b 1 B Flag to indicate if request 
pkt in use 

TCBReqgPkt +12c 4 D 1/O request packet for 
thread 

TCBpMemStatCur +130 4 D Current structure being 
filled in 

TCBMemStat 3C Ss statistics structure 

TCBSysTime 4 D time spent in system code 

TCBUserTime 4 D time spent in user code 

TCB_pPVDBThd +178 4 D Ptr to Perfview Data Block 
for this thread (pvdb_thd_s). 

TCB_flDbg 4 

TCBCpl2_ESP 4 Saved TSS CPL2 stack 
pointer. 

TCBCpl2_SS 2 WwW Saved TSS CPL2 stack 
segment. 

TCBNewFlags +186 1 WwW Value copied from 
ptda_NewFiles 

TCBEntryActions 1 B Kernel entry force flags 

TCBSig_pend 2 WwW bit vector of pending signals 

TCBSig_holding 2 Ww bit vector of postponed 
signals 

TCBSig_cur +18c 2 WwW bit vec of signals being 
processed 

TCBXcptRepRec 4 D report record of active 
exception 

TCBSig_termtid 2 Ww 

TCBSecbits 1 B Security bits 54735 

TCBspbytes 1 B To keep size 4*N 54735 

TCB_ulSRIndex 4 D 

TCBMiscFlags 1 D Used for hard error 
processing 

TCBModeFlags 2 D Mode flags for OPEN - for 
WhatVolume 

TCBSpareFlags 1 B Spare flags 

TCBLibiFlags 1 B 

TCBFiller 1 B 

TCB_ProcNameBuf 4 D Pointer to procedure name 

TCB_ObjNameBuf +1a4 4 D Pointer to object name 
buffer 

TCB_TmpNameBuf 4 aka TCB_TgtModNameBuf 

TCB_SrcModNameBuf 4 Used by loader 

TCB_FaultBuf 4 D 
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Type Description 


TCB_ObjNameBufL Ww Length of object name 
buffer 
TCB_TmpNameBufL 2 Ww 
TCB_SrcModNameBufL 2 Ww 
2 WwW 
TCBSecchild +1bc 4 D Child Security data 54735 
Description 
INIT_ROUTINE_FAILED (0x01) 84537 Set if dll init routine failed 


3.5.2.4 Thread Control Block for OS/2 V2.11 


Field Name Offset Length Type Description 
TCBOrdinal +0 2 WwW Ordinal number of thread in 
PTDA 
TCBForcedActions +4 4 D Bit vector of forced actions 
TCBpPTDA +8 4 D Pointer to the PTDA 
TCBpTSD +C 4 D Pointer to thread swappable 
data 
4 D Pointer to thread info block 
TCBpTCBNext +14 4 forward link to next (active) 
TCB 
TCBcbStackMax +18 4 Virtual size of stack object 
TCBcbStackCur +1¢ 4 Committed size of stack 
object 
4 D Virtual base of stack 
TCBpStack16Lo +24 4 D Virtual base of 16-bit stack 
TCBpStack16Hi +28 4 D Virtual limit of 16-bit stack 
TCBpLibiHead +2C 4 D Link to libi load data area 
4 D Link to libi load data area 
TCBpLibiFree +34 4 D Link to libi free data area 
TCB_pcriFrameType +38 4 D stack frame type 
TCB_pFrameBase +3C 4 D stack frame base pointer 
8 D local context hook head 
TCB_phookOwnerHead +48 4 D linked list of hook blocks 
TCBpteKStackTCBO +4c¢ 4 D KStack page 0 of TCB 
TCBpteKStackTCB1 +50 4 D KStack page 1 of TCB 
TCBpteKStackPTDAO +58 4 D KStack page 0 of PTDA 
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Length Type Description 
TCBpteKStackPTDA1 4 D KStack page 1 of PTDA 
TCBpteKStackPTDA2 4 D KStack page 2 of PTDA 
TCBCurrTCB 4 D SS-relative offset of Current 
TCB 
4 D SS-relative offset of Current 
TSD 
TCBBiasTCB 4 D stack-to-flat TCB conversion 
value 
TCBBiasTSD +70 4 D stack-to-flat TSD conversion 
value 
TCBDMAAdd +74 4 User’s I/O transfer address 
TCBSecPos +78 4 D Position of first sector 
accessed within file 
TCBThisSFT 4 D pointer to SFT we’re 
working with 
TCBValSec 4 D Number of valid (previously 
written) sectors 
TCBpRTCB 4 D Redirector TCB (Used by 
LANMAN) 
2 Ww process ID for file sharing 
checks 
TCBUser_ID 2 Ww user ID for file sharing 
checks 
TCBfSharing 1 B non-zero ==> no 
redirection 
TCBSrvAttrib 1 B see SetAttrib/file.asm 
1 B JFN flag bits for current fil 
handle 
TCBAllowed 1 B Allowed | 24 answers (see 
allowed_) 
TCBOpCookie 4 D server’s per file cookie 
TCBOpFlags 2 Ww whether server wants 
oplock, etc. 
4 D currently assigned buffer 
TCBThishVPB 2 Ww handle of current VPB 
TCBNextAdd 2 WwW 
TCBBytSecPos 2 WwW position of first byte within 
sector 
2 WwW 
TCBLastPos 2 Ww 
TCBBytCnt1 2 WwW Number of bytes in 1st 
sector 
TCBBytCnt2 2 WwW # of bytes in last sector 
TCBSecCnt 2 W number of whole sectors 
TCBSecClusPos +aa 1 B posit of first sector within 


cluster 
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| Offset | Length Type Description 
TCBBufHE +ab 1 B How to handle a HardError 
TCBactBufHE +ac 1 B action response from user 
on HardErr 
TCBflOLock 1 B NZ if TCBLockHndl is valid 
Cc S) Lock handle of user mem 
TCBThisCDS 4 D Address of current CDS 
TCBThisFSC 4 D address of current FSC 
TCBpTmpCDS 4 D Address of dummycds 
2 Ww Address of current OpenBuf 
TCBpSearchBuf 2 W Address of SearchBuf 
TCBFailErr 2 WwW NZ if user did FAIL on | 24 
TCB_SemInfo 4 D 16-bit addr of the ramsem 
blocked upon 
4 D debugger display address 
for ksems 
TCB_NPX_Buffer 4 
TCBpTCBWaitNext 4 Next waiting TCB 
TCBpTCBWaitList 4 Threads waiting for me to 
die 
1 B Scheduler queue location 
(actual) 
TCBState 1 B Current scheduler state 
(desired) 
TCBWakeFlags 1 B TKSleep/TKWakeup Flags 
TCBcWindowBoost 1 B Window Boost count 
1 B Priority Class (user) 
TCBPriLevel 1 B Priority Level (user) 
TCBPriClassMod 1 B Priority Class modifier bits 
TCBSchFlags 1 B Misc. Scheduler flags 
2 Ww Calculated Priority 
TCBPriorityMin 2 Ww Minimum Scheduling priority 
TCBcBoostLock 4 D Kernel Boost Lock nesting 
count. 
TCBpTCBPriNextQ 4 D Next priority queue in chain 
4 Previous priority queue in 
chain 
TCBpTCBPriHigher 4 D Higher priority thread 
TCBpTCBPriLower 4 D Lower priority thread 
TCBpTCBPriNext 4 D Next same-priority thread 
4 D Prev same-priority thread 
TCBpTCBWakeup +108 4 D TKQueryWakeup TCB list 
TCBSleepID +10c 4 D Sleep ID this TCB is 
sleeping on 
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Field Name | Offset | Length Type Description 

TCBtoe +110 14 Ss Timeout/Starvation Timeout 
element 

TCBCheckedSig +124 1 B Used by the loader 

TCBfSwapping +125 1 B status of swapping 

TCBVollONest +126 1 B nesting level of 
FSH_DoVollO 

TCBRegPktFlg +127 1 B Flag to indicate if request 
pkt in use 

TCBReqPkt +128 4 D 1/O request packet for 
thread 

TCBpMemStatCur +12c 4 D Current structure being 
filled in 

TCBMemStat 3C iS) statistics structure 

TCBSysTime +16c 4 D time spent in system code 

TCBUserTime +170 4 D time spent in user code 

TCB_pPVDBThd +174 4 D Ptr to Perfview Data Block 
for this thread (pvdb_thd_s). 

TCBCpl2_ESP +17c 4 Saved TSS CPL2 stack 
pointer. 

TCBCpl2_SS +180 2 WwW Saved TSS CPL2 stack 
segment. 

TCBNewFlags +182 1 Ww Value copied from 
ptda_NewFiles 

TCBEntryActions 1 B Kernel entry force flags 

TCBSig_pend +184 2 WwW bit vector of pending signals 

TCBSig_holding +186 2 Ww bit vector of postponed 
signals 

TCBSig_cur +188 2 Ww bit vec of signals being 
processed 

TCBXcptRepRec +18a 4 D report record of active 
exception 

TCBSig_termtid +18e 2 WwW 

TCBSecbits +190 1 B Security bits 54735 

TCBspbytes +191 1 B To keep size 4*N 54735 

TCB_ulSRindex 4 D 

TCBMiscFlags +196 1 D Used for hard error 
processing 

TCBModeFlags +197 2 D Mode flags for OPEN - for 
WhatVolume 

TCBSpareFlags +199 1 B Spare flags 

TCBLibiFlags 1 B 

TCBFiller +19b 1 B 

TCB_ProcNameBuf +19c 4 D Pointer to procedure name 

TCB_ObjNameBuf +1a0 4 D Pointer to object name 
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buffer 


TCB_TmpNameBuf 4 D aka TCB_TgtModNameBuf 
TCB_SrcModNameBuf 4 D Used by loader 
TCB_FaultBuf 4 D 
buffer 

TCB_TmpNameBufL 2 Ww 
TCB_SrcModNameBufL 2 Ww 
TCB_FaultBufL 2 Ww 

4 D Child Security data 54735 


3.5.3. Thread Swappable Data for OS/2 Warp V3.0 ALLSTRICT Kernel 


For TSD formats for other versions of OS/2 see: 


3.5.3.1, “Thread Swappable Data for OS/2 Warp V3.0 RETAIL Kernel” on 


page 122 


3.5.3.2, “Thread Swappable Data for OS/2 V2.11 ALLSTRICT Kernel” on 


page 123 


3.5.3.3, “Thread Swappable Data for OS/2 V2.11 RETAIL Kernel” on page 124 


Pointers 


TCBpTSD points to the TSD associated with a TCB 


CurrTSD points to the current TSD. 


Locations 


System Arena. 


VM Owner 
tsd (Oxffcd) 


Format 

TSDpad +0 1000 Dummy page to catch faults 
TSDUserStack +1000 F98 WwW Thread’s kernel stack 
TSDUserESP +1f98 4 D Saved user stack pointer 

2 WwW Saved user stack segment 
TSDUserSSPad 2 Ww Pad word pushed by gate 
TSDKernelESP 4 D Saved kernel stack pointer. 
TSDpTCB 4 D Link to TCB 

4 D ptr to local fault handler in 

effect 

TSDTrapNum +1fac 4 TrapNum from the last fault 
TSDerrcFault +1fb0 4 error code from the last 


fault 
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Field Name | Offset | Length Type Description 


TSDpljmp 4 D Buffer saved by 
TKCatchFault 


TSDselFault 2 Ww faulting selector 

TSDCpl2_SSSize 2 WwW Size of ring 2 stack - at 
least that’s what the user 
believes 


TSDdescKStackSS 


LDT table descriptor 
SS descriptor 


TSDdescFPEM reserved descriptor slot 


TSDdescTIB FS mapping to TIB 


TSDulExitCode +1fde Proposed Thread Exit code 
(for dbg) 
D 


TSDerridFault error id from page fault 


& ] CO} CO] @]o 
O;O0;O0;0;0 


aN 


TSDPFErr 4 actual error from 
PGPagefault 
TSDIDbgRangeStart 4 D 
[Tsoibberenseena id vite —+ 4 
TSDIDbgLastAddr 4 D 
TSDpPCB 4 D Pointer to Profile Control 


Block 


iN 


TSDpDLLTerm Pointer to data buffer 


D 
TSDcObjSem D Count of object semaphores 
held 


3.5.3.1 Thread Swappable Data for OS/2 Warp V3.0 RETAIL Kernel 


iN 


Field Name Offset Length Type Description 

TSDUserStack +0 F9C Ww Thread’s kernel stack 

TSDUserESP +f9C 4 D Saved user stack pointer 

TSDUserSS 2 WwW Saved user stack segment 

TSDUserSSPad +fa2 2 WwW Pad word pushed by gate 

TSDKernelESP +fa4 4 D Saved kernel stack pointer. 

TSDpTCB +fa8 4 D Link to TCB 

TSDpfnFault +fac 4 D ptr to local fault handler in 
effect 

TSDTrapNum +fb0 4 TrapNum from the last fault 

TSDerrcFault +fb4 4 error code from the last 
fault 

TSDpljmp +f{b8 4 D Buffer saved by 
TKCatchFault 

TSDselFault 2 WwW faulting selector 

TSDCpl2_SSSize +fbe 2 W Size of ring 2 stack - at 
least that’s what the user 
believes 
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TSDdescLDT +fc0 8 D LDT table descriptor 
TSDdescKStackSS +fc8 8 D SS descriptor 
TSDdescFPEM +fd0 8 D reserved descriptor slot 
TSDulExitCode +fed 4 D Proposed Thread Exit code 
(for dbg) 
TSDerridFault +fe4 4 D error id from page fault 
TSDPFErr +fe8s 4 D actual error from 
PGPagefault 
[TsbibbaRaneesian ——_—~ivves—~*di ; 
TSDIDbgRangeEnd +ff0 4 D 
TSDIDbgLastAddr +ff4 4 D 
TSDpPCB +ff8 4 D Pointer to Profile Control 
Block 
4 D Pointer to data buffer 


3.5.3.2 Thread Swappable Data for OS/2 V2.11 ALLSTRICT Kernel 


Field Name Type Description 

TSDpad B Dummy page to catch faults 

TSDUserStack Ww Thread’s kernel stack 

4 D Saved user stack pointer 

TSDUserSS 2 WwW Saved user stack segment 

TSDUserSSPad 2 WwW Pad word pushed by gate 

TSDKernelESP 4 D Saved kernel stack pointer. 

TSDpfnFault 4 D ptr to local fault handler in 
effect 

TSDTrapNum 4 D TrapNum from the last fault 

TSDerrcFault 4 D error code from the last 
fault 
TKCatchFault 

TSDselFault 2 WwW faulting selector 

TSDCpl2_SSSize 2 WwW Size of ring 2 stack - at 
least that’s what the user 
believes 

TSDdescLDT 8 D LDT table descriptor 

TSDdescFPEM 8 D reserved descriptor slot 

TSDdescTIB 8 D FS mapping to TIB 

TSDulExitCode 4 D Proposed Thread Exit code 
(for dbg) 
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TSDerridFault 4 D error id from page fault 

TSDPFErr 4 D actual error from 
PGPagefault 

TSDIDbgRangeStart 4 D 

jTsbIDberenseena =i tte +d 

TSDIDbgLastAddr 4 D 

TSDpPCB 4 D Pointer to Profile Control 
Block 

TSDpDLLTerm 4 Pointer to data buffer 

4 Count of object semaphores 


TSDcObjSem 


held 


3.5.3.3 Thread Swappable Data for OS/2 V2.11 RETAIL Kernel 


Field Name Offset Length Type Description 
TSDUserStack +0 F9C WwW Thread’s kernel stack 
TSDUserESP +f9c 4 D Saved user stack pointer 
2 WwW Saved user stack segment 
TSDUserSSPad +fa2 2 WwW Pad word pushed by gate 
TSDKernelESP +fa4 4 D Saved kernel stack pointer. 
TSDpTCB +fa8 4 D Link to TCB 
4 D ptr to local fault handler in 
effect 
TSDTrapNum +fb0 4 TrapNum from the last fault 
TSDerrcFault +fb4 4 error code from the last 
fault 
TSDpljmp +fb8 4 D Buffer saved by 
TKCatchFault 
TSDCpl2_SSSize +fbe WwW Size of ring 2 stack - at 
least that’s what the user 
believes 
TSDdescLDT +fc0 8 D LDT table descriptor 
TSDdescKStackSS +fc8 8 D SS descriptor 
8 D reserved descriptor slot 
TSDdescTIB +fd8 8 D FS mapping to TIB 
TSDulExitCode +fed 4 D Proposed Thread Exit code 
(for dbg) 
TSDerridFault +fe4 4 error id from page fault 
PGPagefault 
TSDIDbgRangeStart t+fec 4 
TSDIDbgRangeEnd +ff0 4 
TSDIDbgLastAddr +ff4 4 D 
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Field Name Type Description 


TSDpPCB +ff8 4 D Pointer to Profile Control 
Block 
TSDpDLLTerm +ffc 4 D Pointer to data buffer 


3.5.4 Per-Task Data Area for OS/2 Warp V3.0 ALLSTRICT Kernel 


For PTDA formats for other versions of OS/2 see: 
3.5.4.1, “Per-Task Data Area for OS/2 Warp V3.0 RETAIL Kernel” on page 131 
3.5.4.2, “Per-Task Data Area for OS/2 V2.11 ALLSTRICT Kernel” on page 136 
3.5.4.3, “Per-Task Data Area for OS/2 V2.11 RETAIL Kernel” on page 141 


Pointers 
TCBpPTDA points to the PTDA associated with a TCB 


CurrTSD points to the current TSD. 
pPTDASelf points to the current PTDA. 


Locations 
System Arena. 


VM Owner 
ptda (Oxffcb) 


Format 
Field Name Offset Length Type Description 
pPTDASelf +4 4 D This PTDA 
pPTDAFirstChild +8 4 D Head of child chain PTDA 
pPTDAExecChild +C 4 D New Child PTDA (Child 


being exec’ed) 


pPTDANextSibling 4 D Next sibling’s PTDA 
pPTDAPrevSibling +14 4 Previous sibling’s PTDA 
ptda_pszproc +18 4 D Pointer to the EXE file this 
process is executing. Used 
by PerfView 
ptda_pTCBHole +1c 4 D Some TCB before first Tid 
‘hole’ 
ptda_pTCBHead +20 4 D Head of list of active TCBs 
owned by this process 
ptda_cTCB +24 2 WwW Number of TCBs in use 
ptda_ctib +26 2 Ww Count of TIBs allocated 
ptda_avatib +28 10 D Pointers to TIB arrays 
ptda_flDbg +3C 4 D 
ptda_ah +40 40 Ss Private arena header 
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Field Name | Offset | Length Type Description 

ptda_pgdata +80 26 Ss 

ptda_environ +a6 2 Ww Handle to process’s envt 
seg 

ptda_pBeginLIBPATH +a8 4 

ptda_pEndLIBPATH +ac 4 D75220- support dynamic 
libpath 

ptda_pgpc +b0 1E0 iS) 

ptda_pPVDBPrc +290 4 D 

ptda_pSGSList +294 4 D 

ptda_pexllist 4 D Flat pointer to exit list data 

ptda_cdllterm +29C 4 D 

WFP_Start +2a0 2 Ww TASKAREA offset for 
working string *REDIR* 

Ren_WFP +2a2 2 Ww WFB pointer for rename 
destination *REDIR* 

WFP_Path_End +2a4 2 Ww End of Path component of 
string. 

Curr_Dir_End +2a6 2 Ww 

CDS_Handle +2a8 34 W *REDIR* 

OEMPtr +2dc 2 WwW 

FgndOnly +2df 1 B Foreground only flag 

ptda_pTCBCritSec +2e0 4 D TCB that did enter CritSec 

ptda_pTCBPriQCritSec +2e4 4 D TCBs awaiting CritSec 
wakeup 

ptda_cCritSec 2 W Critical Section Count 

CurrentPDB +2ea 2 Currently active PDB (V86 
segment) 

DTAddr +2eC 4 D User’s I/O transfer address 
*REDIR* 

seltss +2f0 2 WwW 

VolID +212 1 B !0 if vol ID found in dir 
search 

NoSetDir +2f3 1 B If TRUE, do not set directory 

SpaceFlag +2f4 1 B Embedded spaces allowed 
in FCB 

VerFlg +215 1 B Initialize with verify off 

LCurDrv +216 1 B Logical current drive - 
Default A: 

PCurDrv +27 1 B Physical drive after assign 
mapping 

Creating +218 1 B 

DelAll +219 1 B 
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Field Name | Offset | Length Type Description 

Found_dev +2fb 1 B True => search found a 
device 3.10 

fSplice +2 fc 1 B True => do a splice in 
transpath 3.10 

ClusFac +2fd 1 B Sectors/cluster used in dir 
search 

PathNameType +2ff 1 

DevPt +300 4 D Address of device found by 
DevName *REDIR* 

DirSec +304 4 D 

NxtClusNum +30a 2 W 

EntFree +30C 2 Ww 

EntLast +30e 2 Ww 

ProcFlag +312 2 Ww If == 1 then this is a 
special process (Swapper or 
screen switch); NO 
removable media buffer will 
be allocated to this process. 

ptda_ForcedActions +314 4 D Pending action bits 

ptda_ulExitCode +318 4 D Exit code of last task 
ptda_ulExitType 4 D Type of exit 

ptda_ulExitTID +320 4 D Exit Thread ID (32-bit 
exceptions) 

ThisCDS +324 4 D Address of current CDS 
*REDIR* 3.10 

ptda_pCDS +328 2 WwW SS relative pointer to a 
curdir struct 

CDSsize +32a 2 W Size of CDS pointed to by 
ThisCDS ONLY used for CDS 
entries in RMP seg 

Sattrib +32C 2 WwW Storage for search attrs 
*REDIR* 3.10 

sPCB +32e 2 W Selector of Profile Control 
Block 

ptda_pPCB +330 4 D Pointer to Profile Control 
Block 

JFN_Max 2 WwW Highest JFN used so far 

NextSrchH +336 2 Ww Next value to use for search 
handle First value used will 
be 2. 

SrchRmp +338 4 D Handle and Selector for 
RMP segment we keep 
search handles in. 

FNotifyLocal_First +33C 2 Ww 
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Field Name | Offset | Length Type Description 

FNotifyLocal_Count +33e 2 WwW 

Sig_ignf +340 2 Ww Bit vector of ignored signals 

Sig_hndf +342 2 Ww Bit vector of handled signals 

Sig_errf +344 2 Ww Bit vector of error 
generating signals 

Sig_attempted +346 2 W Bit vector of signals we’ve 
tried to handle with 32-bit 
exceptions 

Sig_arg +348 10 WwW Byte vector of signal 
arguments 

Sig_termtid +358 2 Ww ‘Terminator’ TID for 
APTERM. 


HoldSigCnt 2 w DOSHOLDSIGNAL counter 

SigFocusCnt +35c 2 WwW PUBLIB 
DOS32SETSIGNALEXCEPTIONROCUS 
count 


JFN_Table +35e 28 Default handle table 


JFN_Flags +386 14 


ptda_rasflag +39a 


SysSemPTDATDbI +39C 100 
SavedHardErr +49c 4 


Default JFN flags table 


RAS trace indicator 


Po 
nlolo|s|als 


ptda_ptdasem +4a0 Cc PTDA semaphore that is, 


inter-thread 


ptda_DLMsem +4ac Cc Ss b732954 Edd PTDA 
semaphore that is, 
inter-thread 

ptda_lidt +4b8 6 WwW Current IDT limit/base 

Csid +4be 2 WwW Command Subtree ID 

Behav_bit +4c0 2 Ww Program behavior bits 

MSW 2 W CPU matching status word 

ptda_rsrclist +4c4 4 D Far pointer to local resource 
list 

ptda_pldrdildHead +4c8 4 D Loader demand load data 
list 

pPrSemTbl +4cc 4 D (void * => PSEM) pointer 
to private semaphore table 

ulPrTbISize 4 Size of pPrSemTbl in dwords 

ulPrTotUsed +4d4 4 D Number of entries in 
pPrSemTbl 

ulPrNextFree +4d8 4 D Next free slot in pPrSemTbl 


hksPrTbl 


4 D Kernel semaphore handle 
for private semaphore table 


Pointer to private bitmap for 
the shared semaphore table 


+ + 
iN iN 
o Q 
° ° 
aN 
iw) 


pShSemBmp 


ulShBmpSize +4e4 4 D Size of pShSemBmp in bits 
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Field Name | Offset | Length Type Description 

hksShBmp +4e8 4 D Kernel semaphore handle 
for private semaphore table 

ulMtxOwned +4ec 4 D Number of mutex owned by 
this process in the two sem 
tables 

ShareRetriesLeft +4f0 2 Ww Number of share/lock viol 
retries 

RetryCount +4f2 2 Ww Num of share/lock retries to 
do 

RetryLoop +44 2 WwW Num of share/lock retry 
delay loops ceb 75871 

ptda_pSrchBuf +4f6 2 Ww Internal search buffer 

ptda_pad1 +4f8 2 WwW 

ptda_TLMA +4fc 4 D In use flag and dword copy 
count 

ptda_TLMABM +500 4 B Thread local memory 

ptda_TLMASizeMap +504 20 B Thread local memory 

A : 

SysCallSfcen +52e 1 B Value of AL on system entry 

SysCall +52f 1 B Last system call processed 

KBD_Mode +530 1 B Keyboard input mode 

ptda_NewFiles +531 1 B If bit one is set, process 
supports // 54400 new files 
(long names) 

AutoFail +532 1 B Non-zero if | 24 FAlLed 
magically 

ptda_direntry +533 20 

CP_Fligs +553 1 Default is no codepage in 
system. 

Exc_vec +574 1C D OSOLETE exception vectors 

ptda_timerhead +590 4 D 

Attrib +594 2 Ww Storage for file attributes 
*REDIR* 

ExtFCB 1 B Extended FCB 

ptda_extsig +597 1 B 

ptda_lanman_sec +598 4 D Used by LANMAN and HPFS 
for security. 

ptda_pad2 +59C 2 WwW Alignment 

ptda_child +5a0 2 Ww New child PTDA handle 
(Child being Exec’ed) 

ptda_childalias +5a2 2 Ww 

ptda_handle +5a4 2 WwW Handle to this segment 
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ptda_module 2 WwW Program module handle for 
process 
ptda_Idthandle 2 Ww 
ptda_Idtpgmap 2 Ww Bitmap of valid LDT pages 
Pptdateteser ——SSC~*iz ee —=*di 
CP_CaseMapTbl 4 D 
codepage_tag 2 Ww The current code page 
JFN_Length 2 W Size of JFN table in bytes 
4 D PM pointer to JFN table 
JFN_Flg_Ptr 4 D Pointer to JFN flags 
Joins 1 B Number of joins 
ExtErr_Locus 1 B Extended Error Locus 
*REDIR* 3.10 
2 WwW Extended Error code 
*REDIR* 3.10 
ExtErr_Action 1 B Extended Error Action 
*REDIR* 3.10 
ExtErr_Class 1 B Extended Error Class 
*REDIR* 3.10 
ptda_infoseg 24 iS) 
CurrTCB 2 WwW Pointer to current TCB 
CurrTSD 2 WwW Pointer to current TSD 
ThisPTDA 2 WwW Selector for this ptda 
2 Ww b726833 NPX emulator CS 
b726833 
ptda_NPX_em_eip +54 4 D b726833 NPX emulator EIP 
b726833 
ptda_pad4 +5f8 2 Ww Alignment b726833 
ptda_signature +5fa 2 B Must contain ”“TD” 
Table 74 (Page 1 of 2). ptda_ForcedActions Flag Definitions 
Name Bit Mask Description 
TK_FF_BUF 0x00000001 Buffer must be released 


TK_FF_EXIT 0x00000002 


TK_FF_CRITSEC 


0x00000004 


Call TKExit (old FF_DES) 


Enter Per-task critical section 


TK_FF_ICE 


0x00000008 


Freeze thread 


TK_FF_NPX 


0x00000010 


TK_FF_TIB 0x00000020 


TK_FF_TRC 


0x00000040 


NPX Error 
Update the TIB 
Enter Debug 


TK_FF_SIG 


0x00000080 


Signal pending 


TK_FF_CTXH 
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0x00000100 


Pending local context hooks 


Table 74 (Page 2 of 2). ptda_ForcedActions Flag Definitions 


Name Bit Mask Description 


TK_FF_STIH 0x00000200 Execute STI hooks 


TK_FF_VDMBP 0x00000400 Execute VDM BP hooks 


TK_FF_RTRY 0x00000800 Retry V86 system call 


TK_FF_PIB 0x00001000 Update the PIB 


TK_FF_SCH 0x00002000 Do Scheduler Processing 


TK_FF_TFBIT 0x00004000 Validate user eflags TF bit 


TK_FF_TIBPRI 0x00008000 Update only the priority fields in TIB 59463 


3.5.4.1 Per-Task Data Area for OS/2 Warp V3.0 RETAIL Kernel 


Field Name Offset Length Type Description 

pPTDAParent +0 4 D Parent PTDA 
pPTDAFirstChild +8 4 D Head of child chain PTDA 
pPTDAExecChild +C¢ 4 D New Child PTDA (Child 


being exec’ed) 


pPTDANextSibling +10 4 D Next sibling’s PTDA 

pPTDAPrevSibling 4 Previous sibling’s PTDA 

ptda_pszproc 4 D Pointer to the EXE file this 
process is executing. Used 
by PerfView 

ptda_pTCBHole 4 D some TCB before first Tid 
‘hole’ 


iN 
iw) 


Head of list of active TCBs 
owned by this process 


ptda_pTCBHead 


+20 


WwW Number of TCBs in use 
ptda_ctib 2 Ww Count of TIBs allocated 
ptda_avatib 10 D Pointers to TIB arrays 
ptda_pdcb 4 D 

Pewee ——SsS~=*id ese ~SC=*d D 
ptda_ah 40 Ss Private arena header 
ptda_pgdata 26 Ss 
ptda_environ 2 WwW handle to process’s envt 
seg 
ptda_pEndLIBPATH 4 D D75220- support dynamic 
libpath 
ptda_pgpc 1E0 Ss 
ptda_pPVDBPrc 4 D 
Petia ossuist ——=«z wee —=*di 0 
ptda_pexllist +298 4 D Flat pointer to exit list data 
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Length Type Description 
ptda_cdllterm 4 D 
WFP_Start 2 Ww TASKAREA offset for 
working string *REDIR* 
Ren_WFP 2 WwW WEB pointer for rename 
destination *~REDIR* 
2 WwW End of Path component of 
string. 
Curr_Dir_End 2 WwW 
CDS_Handle 34 WwW *REDIR* 
OEMPtr 2 WwW 
1 B 
FgndOnly 1 B foreground only flag 
ptda_pTCBCritSec 4 D TCB that did enter CritSec 
ptda_pTCBPriQCritSec 4 D TCBs awaiting CritSec 
wakeup 
2 WwW Critical Section Count 
CurrentPDB 2 Currently active PDB (V86 
segment) 
DTAddr 4 D User’s I/O transfer address 
*REDIR* 
seltss 2 WwW 
1 B !0 if vol ID found in dir 
search 
NoSetDir 1 B If TRUE, do not set 
directory 
SpaceFlag 1 B Embedded spaces allowed 
in FCB 
VerFlg 1 B Initialize with verify off 
1 B Logical current drive - 
Default A: 
PCurDrv 1 B physical drive after assign 
mapping 
Creating 1 B 
DelAll 1 B 
1 B 
Found_dev 1 B true => search found a 
device 3.10 
fSplice 1 B true => do a splice in 
transpath 3.10 
ClusFac 1 B sectors/cluster used in dir 
search 
1 B components found 3.10 
PathNameType 1 B 
DevPt 4 D Address of device found by 
DevName *REDIR* 
DirSec 4 D 
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Field Name 


DirStart +308 
NxtClusNum +30a 


Length Type Description 


EntFree +30C 


EntLast +30e 


LastEnt +310 
ProcFlag +312 


MP] mM] wm] rm] mw] Pw 
=/=/=/=/= 


if == 1 then this is a 
special process (Swapper or 
screen switch); NO 
removable media buffer will 
be allocated to this process. 


ptda_ForcedActions +314 


ptda_ulExitCode +318 


ptda_ulExitType +31¢ 
ptda_ulExitTID +320 


pending action bits 


Exit code of last task 
Type of exit 


Exit Thread ID (32-bit 
exceptions) 


Address of current CDS 
*REDIR* 3.10 


A; RL RT RR 
O;O0;0;0 


ThisCDS +324 


iN 
iw) 


ptda_pCDS +328 2 WwW SS relative pointer to a 
curdir struct 

CDSsize +32a 2 WwW Size of CDS pointed to by 
ThisCDS ONLY used for CDS 
entries in RMP seg 

Sattrib +32¢ 2 WwW Storage for search attrs 
*REDIR* 3.10 

sPCB +32e 2 WwW Selector of Profile Control 


Block 


ptda_pPCB +330 4 D Pointer to Profile Control 
Block 

JFN_Max +334 2 Ww highest JFN used so far 

NextSrchH +336 2 Ww Next value to use for search 
handle First value used will 
be 2. 

SrchRmp +338 4 D Handle and Selector for 


RMP segment we keep 
search handles in. 


FNotifyLocal_First +33 


ro 
= 


FNotifyLocal_Count +33e 2 WwW 

Sig_ignf +340 2 WwW bit vector of ignored 
signals 

Sig_hndf +342 2 WwW bit vector of handled 
signals 

Sig_errf +344 2 Ww bit vector of error 
generating signals 

Sig_attempted +346 2 WwW bit vector of signals we’ve 
tried to handle with 32-bit 
exceptions 

Sig_arg +348 10 Ww byte vector of signal 
arguments 
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Field Name | Offset | Length Type Description 

Sig_termtid +358 2 Ww ‘Terminator’ TID for 
APTERM. 

HoldSigCnt +35a 2 WwW DOSHOLDSIGNAL counter 

SigFocusCnt +35¢ 2 WwW PUBLIB 
DOS32SETSIGNALEXCEPTIONRFOCUS 
count 


28 WwW default handle table 
JFN_Flags +386 14 B default JFN flags table 
ptda_rasflag +39a 2 Ww RAS trace indicator 
SysSemPTDATDI +39C 100 cS) 

[Sevesherser ——~S=*d nate —=*di 0 
ptda_ptdasem +4a0 8 Ss PTDA semaphore that is, 

inter-thread 
ptda_DLMsem +4a8 8 Ss b732954 Edd PTDA 
semaphore that is, 
inter-thread 
ptda_lidt +4b0 6 Ww current IDT limit/base 
Behav_bit +4b8 2 Ww program behavior bits 
MSW +4ba 2 WwW CPU matching status word 
ptda_rsrclist +4bc 4 D far pointer to local resource 


list 


ptda_pldrdidHead +4c0 4 D loader demand load data 
list 

pPrSemTbl +4c4 4 D (void * => PSEM) pointer 
to private semaphore table 

ulPrTbISize +4c8 4 D size of pPrSemTbl in 
dwords 

ulPrTotUsed +4cc 4 D number of entries in 


pPrSemTbl 


ulPrNextFree 4 next free slot in pPrSemTbl 

hksPrTbl +4d4 4 D kernel semaphore handle 
for private semaphore table 

pShSemBmp +4d8 4 D pointer to private bitmap 
for the shared semaphore 
table 

ulShBmpSize +4dc 4 size of pShSemBmp in bits 


hksShBmp +4e0 4 kernel semaphore handle 
for private semaphore table 

ulMtxOwned +4e4 4 D number of mutex owned by 
this process in the two sem 
tables 

ShareRetriesLeft +4e8 2 WwW number of share/lock viol 
retries 

RetryCount +4ea 2 WwW num of share/lock retries to 
do 
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RetryLoop +4ec 2 Ww num of share/lock retry 
delay loops ceb 75871 
ptda_pSrchBuf +4ee 2 Ww internal search buffer 
ptda_pad1 +4f0 2 Ww 
pide povensut——=S=*d ewe —=«*d w 
ptda_TLMA +4f4 4 D in use flag and dword copy 
count 
ptda_TLMABM +4f8 4 B thread local memory 
ptda_TLMASizeMap +4fc 20 B thread local memory 
A : 
SysCallSfcen +526 1 B Value of AL on system 
entry 
SysCall +527 1 B Last system call processed 
KBD_Mode +528 1 B Keyboard input mode 
ptda_NewFiles 1 B If bit one is set, process 
supports // 54400 new files 
(long names) 
AutoFail +52a 1 B Non-zero if | 24 FAlLed 
magically 
ptda_direntry +52b 20 
CP_Flgs +54b 1 B Default is no codepage in 
system. 
Exc_vec +56c 1C D OSOLETE exception vectors 
ptda_timerhead +588 4 D 
Attrib +58c 2 WwW storage for file attributes 
*REDIR* 
ptda_extsig +58f 1 B 
ptda_lanman_sec +590 4 D Used by LANMAN and 
HPFS for security. 
ptda_pad2 +594 2 Ww alignment 
Fptdapesseia——=SCS~=*dziBC«*d w 
ptda_child +598 2 Ww New child PTDA handle 
(Child being Exec’ed) 
ptda_childalias +59a 2 Ww 
ptda_handle +59C 2 WwW handle to this segment 
2 WwW program module handle for 
process 
ptda_Idthandle +5a0 2 Ww 
ptda_Idtpgmap +5a2 2 Ww Bitmap of valid LDT pages 
ptda_ldtaddr +5a4 4 D 
[op cesemapte ——=«dsvas—=*di 0 
codepage_tag +5ac 2 Ww the current code page 
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Field Name | Offset | Length Type Description 

JFN_Length +5ae 2 W Size of JFN table in bytes 

JFN_pTable +5b0 4 D PM pointer to JFN table 

JFN_Flg_Ptr +5b4 4 D pointer to JFN flags 

ExtErr_Locus +5b9 1 B Extended Error Locus 
*REDIR* 3.10 

ExtErr +5ba 2 Ww Extended Error code 
*REDIR* 3.10 

ExtErr_Action +5bc 1 B Extended Error Action 
*REDIR* 3.10 

ExtErr_Class +5bd 1 B Extended Error Class 
*REDIR* 3.10 

ptda_infoseg +5be 24 Ss 

ptda_pad3 +5e2 2 Ww alignment 

CurrTCB +5e4 2 WwW pointer to current TCB 

CurrTSD 2 WwW pointer to current TSD 

ThisPTDA +5e8 2 WwW Selector for this ptda 

ptda_NPX_em_cs +5ea 2 WwW b726833 NPX emulator CS 
b726833 

ptda_NPX_em_eip +5ec 4 D 6726833 NPX emulator EIP 
b726833 

ptda_pad4 2 Ww alignment b726833 

ptda_signature +5f2 2 B must contain “TD” 


3.5.4.2 Per-Task Data Area for OS/2 V2.11 ALLSTRICT Kernel 


Field Name Offset Length Type Description 
pPTDAParent +0 4 D Parent PTDA 
pPTDASelf 4 D This PTDA 
pPTDAFirstChild 4 D Head of child chain PTDA 
pPTDAExecChild 4 D New Child PTDA (Child 
being exec’ed) 
pPTDANextSibling 4 Next sibling’s PTDA 
pPTDAPrevSibling 4 Previous sibling’s PTDA 
ptda_pszproc 4 Pointer to the EXE file this 
process is executing. Used 
by PerfView 
ptda_pTCBHole 4 D some TCB before first Tid 
‘hole’ 
ptda_pTCBHead 4 D Head of list of active TCBs 
owned by this process 
ptda_cTCB 2 Ww Number of TCBs in use 
ptda_ctib +26 2 Ww Count of TIBs allocated 
ptda_avatib +28 10 D Pointers to TIB arrays 
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Field Name | Offset =| Length Type Description 

ptda_pdcb +38 4 

ptda_flDbg +3C 4 D 

ptda_ah +40 40 Ss Private arena header 

ptda_environ +a6 2 WwW handle to process’s envt 
seg 

ptda_pgpc +a8 400 Ss 

ptda_pmemstatcur +4a8 4 D 

ptda_memstat 3C Ss 

ptda_pPVDBPrc +4e8 4 D 

ptda_pSGSList +4ec 4 D 

ptda_pexllist +4f0 4 D Flat pointer to exit list data 

ptda_cdllterm 4 D 

WFP_Start +4f8 2 W TASKAREA offset for 
working string *REDIR* 

Ren_WFP +4fa 2 Ww WFB pointer for rename 
destination *~REDIR* 

WFP_Path_End +4fc 2 Ww End of Path component of 
string. 

CDS_Handle +500 34 W *REDIR* 

OEMPtr +534 2 WwW 

LIS_Fgnd +536 1 B 

FgndOnly 1 B foreground only flag 

ptda_pTCBCritSec +538 4 D TCB that did enter CritSec 

ptda_pTCBPriQCritSec +53¢ 4 D TCBs awaiting CritSec 
wakeup 

ptda_cCritSec +540 2 WwW Critical Section Count 

CurrentPDB +542 2 Ww Currently active PDB (V86 
segment) 

DTAddr +544 4 D User’s I/O transfer address 
*REDIR* 

seltss +548 2 Ww 

VolID +54a 1 B !0 if vol ID found in dir 
search 

NoSetDir +54b 1 B If TRUE, do not set 
directory 

SpaceFlag +54c 1 B Embedded spaces allowed 
in FCB 

VerFlg +54d 1 B Initialize with verify off 

LCurDrv +54e 1 B Logical current drive - 
Default A: 

PCurDrv +54f 1 B physical drive after assign 
mapping 

Creating +550 1 B 
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Field Name | Offset | Length Type Description 

DelAll +551 1 B 

FoundDel +552 1 B 

Found_dev +553 1 B true => search found a 
device 3.10 

fSplice +554 1 B true => do a splice in 
transpath 3.10 

ClusFac +555 1 B sectors/cluster used in dir 
search 

cMeta +556 1 B components found 3.10 

PathNameType +557 1 

DevPt +558 4 D Address of device found by 
DevName *REDIR* 

DirSec +55c¢ 4 D 

DirStart +560 2 WwW 

NxtClusNum +562 2 WwW 

ee Ww 

EntLast +566 2 Ww 

LastEnt +568 2 Ww 

ProcFlag +56a 2 WwW if == 1 then this is a 
special process (Swapper or 
screen switch); NO 
removable media buffer will 
be allocated to this process. 

ptda_ForcedActions 4 D pending action bits 

ptda_ulExitCode +570 4 D Exit code of last task 

ptda_ulExitType +574 4 D Type of exit 

ptda_ulExitTID +578 4 D Exit Thread ID (32-bit 
exceptions) 

ThisCDS +57¢ 4 D Address of current CDS 
*REDIR* 3.10 

ptda_pCDS +580 2 W SS relative pointer to a 
curdir struct 

CDSsize +582 2 W Size of CDS pointed to by 
ThisCDS ONLY used for CDS 
entries in RMP seg 

Sattrib +584 2 WwW Storage for search attrs 
*REDIR* 3.10 

sPCB +586 2 WwW Selector of Profile Control 
Block 

ptda_pPCB +588 4 D Pointer to Profile Control 
Block 

JFN_Max +58c 2 Ww highest JFN used so far 

NextSrchH +58e 2 Ww Next value to use for search 
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handle First value used will 
be 2. 


Field Name | Offset | Length Type Description 


SrchRmp +590 4 D Handle and Selector for 
RMP segment we keep 
search handles in. 


FNotifyLocal_First +594 2 Ww 

FNotifyLocal_Count +596 2 Ww 

Sig_ignf +598 2 WwW bit vector of ignored 
signals 

Sig_hndf +59a 2 Ww bit vector of handled 
signals 

Sig_errf +59C 2 Ww bit vector of error 
generating signals 

Sig_attempted +59e 2 Ww bit vector of signals we’ve 
tried to handle with 32-bit 
exceptions 

10 WwW byte vector of signal 

arguments 

Sig_termtid 2 WwW ‘Terminator’ TID for 
APTERM. 

HoldSigCnt 2 WwW DOSHOLDSIGNAL counter 

SigFocusCnt 2 W PUBLIB 
DOS32SETSIGNALEXCEPTIONROCUS 
count 


JEN_Table 28 W default handle table 

JFN_Flags +5de 14 B default JFN flags table 

ptda_rasflag +5f2 2 Ww RAS trace indicator 

SysSemPTDATDbI +514 100 Ss 

SavedHardérr 4 0 

ptda_ptdasem +6f8 Cc Ss PTDA semaphore that is, 
inter-thread 

ptda_DLMsem +704 Cc Ss b732954 Edd PTDA 
semaphore that is, 
inter-thread 

ptda_lidt +710 6 Ww current IDT limit/base 

2 W Command Subtree ID 

Behav_bit +718 2 Ww program behavior bits 

MSW +71a 2 WwW CPU matching status word 

ptda_rsrclist +71¢c 4 D far pointer to local resource 
list 

ptda_pldrdildHead +720 4 D loader demand load data 
list 

pPrSemTbl +724 4 D (void * => PSEM) pointer 
to private semaphore table 

ulPrTblSize +728 4 D size of pPrSemTbl in 
dwords 

ulPrTotUsed +72C 4 D number of entries in 
pPrSemTbl 


ulPrNextFree 4 D next free slot in pPrSemTbl 
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Field Name | Offset =| Length Type Description 

hksPrTbl +734 4 D kernel semaphore handle 
for private semaphore table 

pShSemBmp +738 4 D pointer to private bitmap 
for the shared semaphore 
table 

ulShBmpSize +73C 4 D size of pShSemBmp in bits 

hksShBmp +740 4 kernel semaphore handle 
for private semaphore table 

ulMtxOwned +744 4 D number of mutex owned by 
this process in the two sem 
tables 

ShareRetriesLeft +748 2 Ww number of share/lock viol 
retries 

RetryCount +74a 2 Ww num of share/lock retries to 
do 

ptda_pad1 2 Ww alignment 

ptda_pSrchBuf +74e 2 Ww internal search buffer 

ptda_LibiError +750 2 Ww reuse same field to hold 
library init errors 

ptda_pOpenBuf +752 WwW 

A : 

SysCallSfcn +75e 1 Value of AL on system 
entry 

SysCall +75f 1 B Last system call processed 

KBD_Mode +760 1 B Keyboard input mode 

ptda_NewFiles +761 1 B If bit one is set, process 
supports // 54400 new files 
(long names) 

AutoFail +762 1 B Non-zero if | 24 FAlLed 
magically 

ptda_direntry +763 20 

CP_Fligs +783 1 Default is no codepage in 
system. 

Exc_vec +7a4 1C D OSOLETE exception vectors 

ptda_timerhead +7c0 4 D 

Attrib +704 2 Ww storage for file attributes 
*REDIR* 

ExtFCB 1 B Extended FCB 

ptda_extsig +7C07 1 B 

ptda_lanman_sec +7c8 4 D Used by LANMAN and 
HPFS for security. 

ptda_pad2 +7CC 2 WwW alignment 

ptda_child +7d0 2 W New child PTDA handle 


(Child being Exec’ed) 
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ptda_childalias +7d2 2 Ww 
ptda_handle +7d4 2 WwW handle to this segment 
ptda_module +7d6 2 WwW program module handle for 
process 
[pide latanste———SSs*dt Ta’ =«*d w 
ptda_Idtpgmap +7da 2 Ww Bitmap of valid LDT pages 
ptda_ldtaddr +7dc 4 D 
CP_CaseMapTbl +7e0 4 D 
JFN_Length +7e6 2 WwW Size of JFN table in bytes 
JFN_pTable +7e8 4 D PM pointer to JFN table 
JFN_Flg_Ptr +7eC 4 D pointer to JFN flags 
ExtErr_Locus +7f1 1 B Extended Error Locus 
*REDIR* 3.10 
ExtErr +7f2 2 WwW Extended Error code 
*REDIR* 3.10 
ExtErr_Action +7f4 1 B Extended Error Action 
*REDIR* 3.10 
1 B Extended Error Class 
*REDIR* 3.10 
ptda_infoseg +7f6 24 Ss 
ptda_pad3 +81a 2 WwW alignment 
CurrTCB +81C 2 WwW pointer to current TCB 
2 W pointer to current TSD 
ThisPTDA +820 2 WwW Selector for this ptda 
ptda_NPX_em_cs +822 2 Ww b726833 NPX emulator CS 
b726833 
ptda_NPX_em_eip +824 4 D b726833 NPX emulator EIP 
b726833 
ptda_signature +82a 2 B must contain “TD” 


3.5.4.3  Per-Task Data Area for OS/2 V2.11 RETAIL Kernel 


Field Name Offset Length Type Description 

pPTDAParent +0 4 D Parent PTDA 

pPTDAFirstChild D Head of child chain PTDA 

pPTDAExecChild D New Child PTDA (Child 
being exec’ed) 

pPTDANextSibling D Next sibling’s PTDA 

pPTDAPrevSibling D Previous sibling’s PTDA 


Chapter 3. OS/2 System Control Block Reference 141 


ptda_pszproc +18 4 D Pointer to the EXE file this 
process is executing. Used 
by PerfView 
ptda_pTCBHole +1¢ 4 D some TCB before first Tid 
‘hole’ 
ptda_pTCBHead +20 4 D Head of list of active TCBs 
owned by this process 
2 W Number of TOBS in use 
ptda_ctib +26 2 Ww Count of TIBs allocated 
ptda_avatib +28 10 D Pointers to TIB arrays 
ptda_pdcb +38 4 D 
Pewee —=SSC=*id ese SC=*d D 
ptda_ah +40 40 Ss Private arena header 
ptda_pgdata +80 26 Ss 
ptda_environ +a6 2 Ww handle to process’s envt 
seg 
ptda_pmemstatcur +4a8 4 D 
ptda_memstat +4ac 3C Ss 
ptda_pPVDBPrc +4e8 4 D 
Petia osstist =i vee =z ° 
ptda_pexllist +4f0 4 D Flat pointer to exit list data 
ptda_cdlilterm +44 4 D 
WFP_Start +4f8 2 WwW TASKAREA offset for 
working string *REDIR* 
2 WwW WEB pointer for rename 
destination *REDIR* 
WFP_Path_End +4fc 2 Ww End of Path component of 
string. 
Curr_Dir_End +4fe 2 Ww 
CDS_Handle +500 34 WwW *REDIR* 
a w 
LIS_Fgnd +536 1 B 
FgndOnly +537 1 B foreground only flag 
ptda_pTCBCritSec +538 4 D TCB that did enter CritSec 
4 D TCBs awaiting CritSec 
wakeup 
ptda_cCritSec +540 2 W Critical Section Count 
CurrentPDB +542 2 Currently active PDB (V86 
segment) 
DTAddr +544 4 D User’s I/O transfer address 
*REDIR* 
sets SSCSC*~C~“‘is S~*d w 
VolID +54a 1 B !0 if vol ID found in dir 


search 
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Field Name | Offset | Length Type Description 

NoSetDir +54b 1 B If TRUE, do not set 
directory 

SpaceFlag +54c 1 B Embedded spaces allowed 
in FCB 

VerFlg +54d 1 B Initialize with verify off 

LCurDrv +54e 1 B Logical current drive - 
Default A: 

PCurDrv +54f 1 B physical drive after assign 
mapping 

Creating +550 1 


DelAll +551 


FoundDel 


= 


+ 
a 
a 
i) 
= 
OW; W)}W| Ww 


Found_dev +553 1 true => search found a 
device 3.10 

fSplice +554 1 B true => do a splice in 
transpath 3.10 

ClusFac +555 1 B sectors/cluster used in dir 


search 


1 B components found 3.10 
PathNameType +557 1 
DevPt +558 4 D Address of device found by 
DevName *REDIR* 
DirSec +55c 4 D 
2 w 
NxtClusNum +562 2 Ww 
EntFree +564 2 WwW 
EntLast +566 2 WwW 
2 w 
ProcFlag +56a 2 WwW if == 1 then this is a 


special process (Swapper or 
screen switch); NO 

removable media buffer will 
be allocated to this process. 


ptda_ForcedActions +56c pending action bits 


ptda_ulExitCode +570 


ptda_ulExitType +574 


Exit code of last task 


Type of exit 


ART RT R 
O;o0;O0;0 


ptda_ulExitTID +578 Exit Thread ID (32-bit 
exceptions) 

ThisCDS +57¢ 4 D Address of current CDS 
*REDIR* 3.10 

ptda_pCDS +580 2 W SS relative pointer to a 
curdir struct 

CDSsize +582 2 WwW Size of CDS pointed to by 


ThisCDS ONLY used for CDS 
entries in RMP seg 


Sattrib +584 2 W Storage for search attrs 
*REDIR* 3.10 
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Field Name | Offset | Length Type Description 

sPCB 2 WwW Selector of Profile Control 
Block 

ptda_pPCB 4 D Pointer to Profile Control 
Block 

JFN_Max 2 WwW highest JFN used so far 

NextSrchH +58e 2 Ww Next value to use for search 
handle First value used will 
be 2. 

SrchRmp +590 4 D Handle and Selector for 
RMP segment we keep 
search handles in. 

FNotifyLocal_First +594 2 Ww 

FNotifyLocal_Count +596 2 Ww 

Sig_ignf +598 2 WwW bit vector of ignored 
signals 

Sig_hndf 2 Ww bit vector of handled 
signals 

Sig_errf 2 Ww bit vector of error 
generating signals 

Sig_attempted 2 Ww bit vector of signals we’ve 
tried to handle with 32-bit 
exceptions 

10 Ww byte vector of signal 
arguments 

Sig_termtid 2 WwW ‘Terminator’ TID for 
APTERM. 

HoldSigCnt 2 Ww DOSHOLDSIGNAL counter 

SigFocusCnt 2 WwW PUBLIB 
DOS32SETSIGNALEXCEPTIONROCUS 
count 

28 Ww default handle table 

JFN_Flags 14 B default JFN flags table 

ptda_rasflag 2 Ww RAS trace indicator 

SysSemPTDATDbI 100 Ss 

4 D 

ptda_ptdasem 8 Ss PTDA semaphore that is, 
inter-thread 

ptda_DLMsem 8 Ss b732954 Edd PTDA 
semaphore that is, 
inter-thread 

ptda_lidt 6 Ww current IDT limit/base 

2 WwW Command Subtree ID 

Behav_bit 2 Ww program behavior bits 

MSW 2 W CPU matching status word 

ptda_rsrclist 4 D far pointer to local resource 
list 
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Field Name | Offset | Length Type Description 
ptda_pldrdildHead +718 4 D loader demand load data 
list 
pPrSemTbl +71¢ 4 D (void * => PSEM) pointer 
to private semaphore table 
ulPrTblSize +720 4 D size of pPrSemTbl in 
dwords 
ulPrTotUsed +724 4 D number of entries in 
pPrSemTbl 
ulPrNextFree 4 D next free slot in pPrSemTbl 
hksPrTbl 4 kernel semaphore handle 
for private semaphore table 
pShSemBmp 4 D pointer to private bitmap 
for the shared semaphore 
table 
ulShBmpSize 4 size of pShSemBmp in bits 
hksShBmp +738 4 D kernel semaphore handle 
for private semaphore table 
ulMtxOwned +73C 4 D number of mutex owned by 
this process in the two sem 
tables 
ShareRetriesLeft +740 2 WwW number of share/lock viol 
retries 
RetryCount +742 2 Ww num of share/lock retries to 
do 
RetryLoop 2 WwW 
ptda_pSrchBuf 2 Ww internal search buffer 
ptda_LibiError 2 Ww reuse same field to hold 
library init errors 
WwW 
Cons_Loc A Ss 
SysCallSfcen 1 B Value of AL on system 
entry 
SysCall 1 B Last system call processed 
1 B Keyboard input mode 
ptda_NewFiles 1 B If bit one is set, process 
supports // 54400 new files 
(long names) 
AutoFail 1 B Non-zero if | 24 FAlLed 
magically 
ptda_direntry 20 
1 B Default is no codepage in 
system. 
Sig_vec 20 D signal handlers 
Exc_vec 1C D OSOLETE exception vectors 
ptda_timerhead 4 D 
2 Ww storage for file attributes 
*REDIR* 
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ExtFCB +7be 1 B Extended FCB 
ptda_extsig +7bf 1 B 
ptda_lanman_sec +7c0 4 D Used by LANMAN and 
HPFS for security. 
ptda_ppgdata +7c6 2 WwW 
ptda_child +7c8 2 Ww New child PTDA handle 
(Child being Exec’ed) 
ptda_childalias +7Ca 2 Ww 
2 WwW handle to this segment 
ptda_module +7ce 2 WwW program module handle for 
process 
ptda_Idthandle +7d0 2 Ww 
ptda_Idtpgmap +7d2 2 Ww Bitmap of valid LDT pages 
Peta teteser ——SS=*iz aa —=*di 0 
CP_CaseMapTbl +7d8 4 D 
codepage_tag +7dc 2 WwW the current code page 
JFN_Length +7de 2 WwW Size of JFN table in bytes 
4 D PM pointer to JFN table 
JFN_Flg_Ptr +7e4 4 D pointer to JFN flags 
Joins +7e8 1 B number of joins 
ExtErr_Locus +7e9 1 B Extended Error Locus 
*REDIR* 3.10 
2 WwW Extended Error code 
*REDIR* 3.10 
ExtErr_Action +7eC 1 B Extended Error Action 
*REDIR* 3.10 
ExtErr_Class +7ed 1 B Extended Error Class 
*REDIR* 3.10 
ptda_infoseg +7ee 24 Ss 
CurrTCB +814 2 WwW pointer to current TCB 
CurrTSD +816 2 WwW pointer to current TSD 
ThisPTDA +818 2 WwW Selector for this ptda 
2 Ww b726833 NPX emulator CS 
b726833 
ptda_NPX_em_eip +81¢c 4 D 6726833 NPX emulator EIP 
b726833 
ptda_pad4 +820 2 Ww alignment b726833 
ptda_signature +822 2 B must contain “TD” 
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3.5.5 Local Information Segement 


Pointers 
SAS field SAS_info_local points to the current LISEG. 


Locations 
dfff:0 is the address of the copy of the LISEG for the current thread and 
process. 


The LISEG for each process is imbedded in the PTDA at ptda_infoseg. 


VM Owner 
infoseg (Oxff75) 


Format 


Table 75 (Page 1 of 2). InfoSegLDT 


Field Name Offset Length Type Description 
LIS_CurProcID 2 WwW Current process ID 
LIS_ParProclID +2 2 Ww Process ID of parent 
LIS_CurThrdPri +4 2 WwW Current thread priority 
LIS_CurThrdID 2 WwW Current thread ID 
2 WwW Screengroup 
LIS_ProcStatus 1 B Process status bits 
LIS_fillbyte1 1 B filler byte 
LIS_Fgnd 2 Ww Current process is in 
foreground 
1 B Current process type 
LIS_fillbyte2 1 B filler byte 
LIS_AX 2 Ww @@V1 Environment 
selector 
LIS_BX 2 Ww @@V1 Offset of command 
line start 
2 Ww @@V1 Length of Data 
Segment 
2 WwW @@V1 STACKSIZE from the 
.EXE file 
2 WwW @@V1 HEAPSIZE from the 
.EXE file 
2 Ww @@V1 Module handle of the 
application 
LIS_DS +1c 2 WwW @@V1 Data Segment 
Handle of application 
LIS_PackSel +1e 2 Ww First tiled selector in this 
EXE 
LIS_PackShrSel +20 2 Ww First selector above shared 
arena 
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Table 75 (Page 2 of 2). InfoSegLDT 


Field Name Offset Length Type Description 

LIS_ PackPckSel +22 2 WwW First selector above packed 
arena 

Table 76. LIS_ProcStatus Flag Definitions 

Name Bit Mask Description 


PS_XITTH1 


Doing ExitList Processing 


Exiting thread 1 


PS_XITALL 


The whole process is exiting 


PS_SYNCPARENT 


PS_DYING 0x40 


Parent cares about termination 


Parent did an exec-and-wait 


Process is dying 


PS_EMBRYO 0x80 


Process in embryonic state 


Table 77. LIS_ProcType Flag Definitions 


Name Value 


LIS_PT_REALMODE 


Description 
Full screen app. 


Real mode process 


PT_VDM 


VDM 


LIS_PT_VIOWIN 


| 
| 
2 


LIS_PT_DETACHED 


A 


VIO windowable app. 


Presentation Manager app. 


Detached app. 


3.5.6 Global Information Segement 


Pointers 


SAS field SAS_info_global points to the current GISEG. 


Locations 


dff4:0 is the address of the copy of the GISEG for the current thread and 


process. 


VM Owner 


infoseg (Oxff75) - shared arena copy 


os2krnl (Oxffaa) - system arena copy 


148 os/2 Debugging 


Format 


Table 78 (Page 1 of 2). InfoSegGDT 


Field Name Offset Length Type Description 

SIS_BigTime +0 4 D Time from 1-1-1970 in 
seconds 

SIS_MsCount +4 4 D Freerunning milliseconds 
counter 

SIS_MinTime +9 1 B Minutes 

SIS_SecTime +a 1 B Seconds 

SIS_HunTime +b 1 B Hundredths of seconds 

2 Ww 


SIS_TimeZone +C Timezone in min from GMT 
(Set to EST) 


SIS_ClkIntrvl 2 Ww Timer interval 
(units=0.0001 secs) 

SIS_DayDate 1 B Day-of-month (1-31) 

SIS_MonDate +11 1 B Month (1-12) 

SIS_DOWDate 1 B Day-of-week (1-1-80 = Tues 
= 3) 

SIS_VerMajor 1 B Major version number 

SIS_VerMinor 1 B Minor version number 

SIS_CurSernGrp 1 B Fgnd screen group # 

SIS_MaxScrnGrp 1 B Maximum number of screen 


groups 


SIS_HugeShfCnt 


SIS_ProtMdOnly 


= 
ies) 


Shift count for huge 
segments 


+ + 
a Ee 
low i) 
a 
w 


Protect-mode-only indicator 


SIS_FgndPID 2 WwW Foreground process ID 

SIS_Dynamic 1 B Dynamic variation flag 
(1=enabled) 

SIS_MaxWait 1 B Maxwait (seconds) 


SIS_MinSlice +20 2 Ww Minimum timeslice 
(milliseconds) 
SIS_MaxSlice 2 WwW Maximum timeslice 
(milliseconds) 
SIS_BootDrv 2 Ww Drive from which system 
was booted 
SIS_mec_table 20 B Table of RAS Major Event 


Codes (MECs) 


SIS_MaxVioWinSG +46 Max. no. of VIO windowable 
SG’s 


= 
ies) 


SIS_MaxPresMgrSG +47 1 B Max. no. of Presentation 
Manager SG’s 
SIS_SysLog +48 2 WwW Error Logging Status 
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Table 78 (Page 2 of 2). InfoSegGDT 


Field Name Offset Type Description 

SIS_MMIOBase +4a WwW Memory mapped 1|/O 
selector 

SIS_MMIOAddr +4c D Memory mapped 1|/O 
address 

SIS_MaxVDMs +50 B Max. no. of Virtual DOS 
machines 


SIS_Reserved +51 1 B 


Table 79. SIS_SysLog Flag Definitions 
Name Bit Mask Description 


LF_LOGENABLE 0x0001 Logging enabled 


LF_LOGAVAILABLE 0x0002 Logging available 


3.5.7 Process Information Block 


Pointers 
PTDA field ptda_avatib points to the PIB for the related process. 


PIB field pib_pchenv points to the process’ environment strings. 


Locations 
Allocated in the process’ private arena. 


VM Owner 
PIB owner id: tktib (Oxff3f) (also used for TIB ownership). 


Environment Owner ID: tkenv (Oxff3e). 
Format 


Table 80. PIB Process Information Block 


Field Name Offset Length Type Description 


pib_ulpid +0 4 D Process ID 


pib_ulppid +4 4 D Parent process I.D. 


pib_hmte +8 4 D Program (.EXE) module 
handle 


pib_pchcmd +C Command line pointer 


pib_pchenv +10 Environment pointer 


pib_flstatus +14 


pib_ultype +18 


Process’ status bits 


Ry; R] AR] PD 
vuljuj/uols 


Process’ type code 
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Table 81. pib_flstatus Flag Definitions 


Name Bit Mask Description 


PS_XITLST 0x01 Doing ExitList Processing 


PS_XITTH1 0x02 Exiting thread 1 


PS_XITALL The whole process is exiting 


PS_SYNCPARENT Parent cares about termination 
PS_WAITPARENT Parent did an exec-and-wait 


PS_DYING Process is dying 


PS EMBRYO Process in embryonic state 


Table 82. pib_ultype Flag Definitions 


Name Description 


LIS_PT_FULLSCRN Full screen app. 
Real mode process 
PT_VDM VDM 

LIS_PT_VIOWIN VIO windowable app. 


LIS_PT_PRESMGR Presentation Manager app. 
LIS_PT_DETACHED Detached app. 


3.5.8 Thread Information Block 


Pointers 
TCB field TCBptib points to the TIB for the related thread. 


TIB field tib_ptib2 points to the associated TIB2. 
GDT Selector 150b maps the TIB and is the default value for the FS register. 


Locations 
Allocated in the process’ private arena. 


VM Owner 
tktib (Oxff3f) (also used for PIB ownership). 


Format 


TIB Thread Information Block system independent section. 
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Field Name | Offset | Type Description 

tib_pexchain D Head of exception handler 
chain 

tib_pstack D Pointer to base of stack 

tib_pstacklimit D Pointer to end of stack 

tib_ptib2 +C Ww Pointer to system specific 
TIB 

tib_version +10 4 D Version number for this TIB 
structure 

tib_ ordinal +14 4 D Thread Ordinal Number 


TIB2 Thread Information Block system dependent section. 


Field Name Offset Length Type Description 

tib2_ultid +0 4 D Thread ID 

tib2 version 4 D Version number for this 
structure 

tib2_usMCCount 2 WwW Must Complete count 

tib2_fMCForceFlag 2 Ww Must Complete force flag 


3.5.9 System Stack Frames Client Register Information 


Pointers 
TCB field TCB_pcriFrameType points to the CRI. 


Locations 
_crilSF locates the Interrupt Stack Frame CRI. 


_criTSF locates the Trap Stack Frame CRI. 

_criVSF locates the VDM Stack Frame CRI. 

_criSEF locates the System Entry Stack Frame CRI. 

_criPASCALSEF locates the PASCAL System Entry Stack Frame CRI. 
_criSSF locates the SCI Stack Frame CRI. 

_criDHF locates the Device Help Stack Frame CRI. 


fpoldstack contains a 32-bit far pointer to the ISF built by the Interrupt Router 
at interrupt time. 


VM Owner 
os2krnl (Oxffaa) 
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Format 


Table 83. CRI Client Register Information 
Field Name Offset Length Type Description 
cri_ulSize +0 4 D size of stack frame 
cri_eax 4 S) eax rip 

4 iS) ebx rip 
cri_ecx 4 S) ecx rip 
cri_edx 4 S) edx rip 
cri_ebp 4 iS) ebp rip 

4 Ss esi rip 
cri_edi 4 S) edi rip 
cri_ds 4 S) ds rip 
cri_es 4 S) es rip 

4 Ss fs rip 
cri_gs 4 iS) gs rip 
cri_cs 4 S) cs rip 
cri_eip 4 iS) eip rip 

4 iS) eflag rip 
cri_ss 4 S) ss rip 
cri_esp 4 iS) esp rip 
cri_cbargs 4 iS) cbargs rip 

4 Ss trapnum rip 
cri_errcode 4 S) errcode rip 
cri_pfnRebuild 4 D 
cri_pfpfnKernelExit 4 D 


Table 84. RIP Register Information Packet 


Field Name | Offset | Type Description 


rip_flags +0 2 WwW Flags 
rip_offset +2 4 Ww Offset of register into stack 
frame 


Table 85 (Page 7 of 2). rip_flags Flag Definitions 
Bit Mask 


Name Description 


KM_RIP_INVALID 0x0001 invalid register 


KM_RIP_INVALID_SET 0x0002 


KM_RIP_WORD 0x0004 
KM_RIP_TSD_RELATIVE | 0x0008 


invalid register to set 


word register 


rip_offset relative to TSD beginning 
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Name 


Table 85 (Page 2 of 2). rip_flags Flag Definitions 


Bit Mask Description 


KM_RIP_C32 


0x0010 32-bit C style call 


ISF Interrupt Manager Stack Frame 


This is what the stack frame looks like when the system is entered through the 
interrupt manager during a hardware interrupt. For a hardware interrupt in a 
VDM context, the stack frame always needs to be a ”“VSF” type so the stack 
frame base is adjusted by ISF_VSF_START. The points the stack frame base to 
“isf_edi” in the regular interrupt frame. The interrupt stack frame has also been 
padded (ISF_STACK_PAD) between the general registers (EDI to EAX) and the 
hardware pushed registers (EIP to SS) with a dummy trap number and error 
code to look like the VSF stack frame. 


Table 86. ISF Interrupt Manager Stack Frame 


Field Name | Offset | Length 


isf_CurrlntLevel 


Description 


isf_gs 


isf_padgs 


isf_padfs 


isf_es 


isf_pades 


isf_padds 


isf_edi 


start of VDM stack frame 


isf_esi 


isf_padesp 


isf_ebx 


isf_edx 


isf_eax 


isf_pad 


isf_eip 


isf_padcs 


isf_eflag 


isf_esp 


isf_padss 


SlS/FISlSS/S/9/ FSS SsFs/S]s S/S; o; sl S/S /e/e/e/2/2/9]2 
Ss 
@ 


Pym; R] RI] mM] mo] RR] o;eR]_ RP R]_ RI] R_ RP RT RL MT MT MT MI] MIT NM] MI] DY] A 
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TSF Trap or Exception Stack Frame 


This is what the stack frame looks like when the system is entered through a 386 
exception (from protected mode). 


Table 87. TSF Trap or Exception Stack Frame 


Field Name Offset Length Description 


tsf_esi +4 


tsf_ebp +8 


tsf_padesp +C 


tsf_edx +14 


tsf_ecx +18 


tsf_eax 


+ [+ 
ine) om 
olo 


+ 
ine) 
fee) 
Pym] A] MLM! ALATA LMT NMI MIL MITMIL MIMI] MTR] HR) HRP RP R] RI] RTA 


tsf_padgs +22 
tsf_fs +24 
tsf_padfs +26 
tsf_pades +2a 
tsf_ds +2C 
tsf_padds +2e 


tsf_errcode +34 


tsf_eip +38 


+ 
eo 
io} 


tsf_cs 


tsf_padcs 


tsf_eflag +40 


+ 
oo 
oO 


tsf_esp +44 


tsf_ss +48 


tsf_padss +4a 


E/e/Fl/Cl sls] o/ololsl sl el elelelelelelolelefselejelela 
xe] 
oO 


KSF Kernel Stack Frame 


This is what the stack frame looks like when the system is re-entered from ring 
0. This is frame used for handling exception while already in kernel mode. 
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Table 88. KSF Kernel Stack Frame 


Field Name 


Offset Length Description 


ksf_edi 


+0 


ksf_esi 


ksf_padesp 


ksf_ebx 


ksf_edx 


ksf_eax 


ksf_gs 


ksf_padgs 


ksf_padfs 


ksf_es 


ksf_pades 


ksf_padds 


ksf_trapnum 


ksf_errcode 


ksf_cs 


ksf_padcs 


ksf_eflag 
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O}S/e/o/olol sl sls sl ele} ese olelelel/eglesecjoja 
xe] 
oO 
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VSF VDM Process Stack Frame 


This is what the stack frame looks like when the system is entered from a VDM 
through an exception, software or hardware interrupt. Most of the 8086 
emulation code uses this stack frame directly for performance. For hardware 
interrupts taken in a VDM (in either V86 mode or protected mode), the interrupt 
stack frame (see ISF) is adjusted to look like this frame. 


The alternate stack frame holds the real or protected mode sensitive registers 
for the other mode. So when the VDM is in protected mode, the last V86 mode 
segment registers CS:EIP and SS:ESP can be accessed. Two things happen with 
the mode switch: 1) the alternate register set is exchanged with the regular set 
(vsf_eip to vsf_padgs is the exchanged with vsf_alteip to vsf_altpadgs), 2) the 
TSS’s ESPO value is changed to the appropriate place in the VSF structure. For 
V86 mode, ESPO points to the begining of the segment registers 
(vsf_gs/vsf_padgs) and for protected mode ESPO points to the SS register 
(vsf_ss/vsf_padss). For protected mode entry, the segments registers are stored 
in vsf_ds to vsf_gs explictly. This makes the V86 mode and protected mode 
stack frames the same for VDDs and the MVDM kernel code. 


Table 89. VSF VDM Process Stack Frame 
Field Name Offset 


Length 


Description 


vsf_edi +0 


vsf_esi 


vsf_padesp 


vsf_ebx 


vsf_edx 


vsf_eax 


vsf_trapnum 


vsf_errcode 


vsf_cs 


vsf_padcs 


vsf_eflag 


vsf_ss 


vsf_padss 


vsf_es 


vsf_ds 


vsf_padds 


vsf_fs 


vsf_gs 


vsf_padgs 


vsf_alteip 


VIL yMNTLwMlLnyNIL NYMOLTL NMI MLM] _ NMI] MTR] RIL ML MLR] iM] MLM MLM] MIL M] MY] MI] MTR IT_R]_ M]_wo]T RIE R_ RR] R]_ RP RR] RR] RTP RP RR 
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SEF System Entry Stack Frame 


This is the frame put on the by the call gate system entry function 
(KMEnterKmodeCallGate or KMEnterKmodeAPI32). 


This frame is used for: 
* 32-bit C APIs, with C callable workers (criSEF) 
* 16-bit PASCAL APls, with C callable workers (criPASCALSEF) 


Table 90. SEF System Entry Stack Frame 


Field Name | Offset | Length 


sef_edi 


Description 


sef_esi 


sef_ebp 


sef_ebx 


sef_edx 


sef_ecx 


sef_gs 


sef_padgs 


sef_fs 


sef_es 


sef_pades 


sef_ds 


sef_retaddr 


sef_cbargs 


sef_eflag 


sef_cs 


sef_padcs 


wP}rmyo;_RI_ AR] PL RPT MIENMINMIENINI NI NMI NMTRI HR] HR] RP] RR] RT 
E/e/T/olo/olslsl sl elelelelelFleloleleljelsejola|a 
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oO 


158 os/2 Debugging 


SCI System Call Interpreter Call Gate Stack Frame 


This is what the stack frame looks like when the system is entered through SCI 
via call gate using the KMEnterKmodeSCl function. 


Table 91. SCI System Call Interpreter Call Gate Stack Frame 


Field Name Offset Length Description 


ssf_esi +4 


ssf_ebp +8 


ssf_padesp +C 


ssf_edx +14 


ssf_ecx +18 


ssf_eax 


ssf_padgs +22 
ssf_fs 424 


ssf_padfs +26 


ssf_pades +2a 


ssf_ds +2C 


ssf_padds +2e 


ssf_thopadr +30 


ssf_cbargs +34 


+ 
= 
io} 
ALA TMI MI MIL MLM MI MIMI HR]_ HR HRP RPT RR] RR] RTA 


O/O/S/ Ss] se ele) el] el EF; Fl olefejelejola 
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The Most Significant Bit of 
cbargs in an SCI stack 
frame is used to denote that 
a 16-bit callgate is being 
used with the SCI 
mechanism. Used by 


dynamic APIs. 
ssf_sciret +38 2 Ww 
ssf_eflag +3a 4 D 
sstee SSC~=‘iz Se ~=*d 
ssf_cs +42 2 WwW 
ssf_padcs +42 2 WwW 
Table 92 (Page 71 of 2). DHF Device Help Stack Frame 
Type Description 


dhf_edi D 
dhf_esi 


D 
dhf_ebp D 
D 


dhf_padesp 
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Table 92 (Page 2 of 2). DHF Device Help Stack Frame 


Field Name Offset Length Type Description 
dhf_ebx +10 4 D 
dhf_edx +14 4 D 
a 
dhf_eax +1c 4 D 
dhf_gs +20 2 Ww 
dhf_padgs +22 2 WwW 
a w 
dhf_padfs +26 2 Ww 
dhf_es +28 2 WwW 
dhf_pades +2a 2 Ww 
ec w 
dhf_padds +2e 2 W 
dhf_eflag +30 4 D 
dhf_scratch +34 4 D 
a 0 
dhf_cs +3C 2 Ww 
dhf_padcs +3e 4 D 


TF Hardware Exception Trap Stack Frame 


Stack frame for the trap manager before we go into kernel mode. 


Table 93. TF Hardware Exception Trap Stack Frame 


Field Name Offset Length Description 


tf_errcode +4 


tf_eip +8 


+ 
a 


tf_cs 


tf_padcs +e 


tf_eflags +10 


tf_esp +14 


tf_ss +18 


tf_padss +1a 


E/E/F/9/s/e/F/eC}/F]a| 
To 
oO 


wP}rmoy, eR] R][ ML rm] eR] RI] A 
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3.5.10 Exit List Entry Data Structure 


Pointers 
PTDA field ptda_pexllist points to the head of Exit List chain. 


Locations 
Allocated from the kernel heaps. 


VM Owner 
tkextlst (Oxffc7) 


Format 

Table 94. EXENT 

Field Name Offset Length Type Description 

exl_next 4 D link to next block/order 

exl_addr 4 D Exit list routine address 

exl_class 2 Ww order and position 0 thru 
Ox1 FF 

exl_type 2 WwW 16:16 or 0:32 

Table 95. exl_type Values 

Name Value Description 

TK_TYPE16 0 

TK_TYPE32 1 

TK_TYPEDT 2 


3.5.11 Exception Handler Structures 


Pointers 
TIB field tib_pexchain points to the head of the chain of 
EXCEPTIONREGISTRATIONRECORDs. 


The first parameter to the exception handler points to the 
EXCEPTIONREPORTRECORD. 


The second parameter to the exception handler points to the 
EXCEPTIONREGISTRATIONRECORD. 


The third parameter to the exception handler points to the 
CONTEXTRECORD. 
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Locations 
Allocated in the Process’ Private Arena,. 


VM Owner 
tktib (Oxff3f) (also used for PIB ownership). 


Format 


Table 96. CONTEXTRECORD Exception Handler Context Record 


Field Name Offset Length Type Description 
ContextFlags +0 4 D Flags 
+4 6c Ss Floating point section 
1c D Floating point environment 
ctx_stack +20 50 iS) Floating point register stack 
(8 FPREG structures) 
+70 10 Ss Segment Register section 
ctx_SegGs +70 4 D GS segment register 
ctx_SegEs +78 4 D ES segment register 
ctx_SegDs +7C 4 D DS segment register 
+80 18 Ss Integer Register section 
ctx_RegEsi +84 4 D ESI register 
ctx_RegEax +88 4 D EAX register 
ctx_RegEbx +8C 4 D EBX register 
ctx_RegEdx +94 4 D EDX register 
+98 18 Ss Control Register section 
ctx_RegEbp +98 4 D EBP register 
ctx_SegCs +a0 4 D CS selector 
ctx_EFlags +a4 4 D Processor Flags register 
ctx_RegEsp +a8 4 D ESP register 
+ac 4 D SS segment register 


Table 97 (Page 1 of 2). FPREG Floating Point Register Stack Element 
Field Name Length Type Description 


losig 4 D Low significance doubleword 


hisig 4 D High significance 
doubleword 
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Table 97 (Page 2 of 2). FPREG Floating Point Register Stack Element 
Field Name Offset Length Type Description 


signexp +8 2 WwW Exponent 


Table 98. ContextFlags Flag Definitions 


Name Bit Mask Description 
CONTEXT_INTEGER 0x00000002L EAX, EBX, ECX, EDX, ESI, EDI 
CONTEXT_SEGMENTS 0x00000004L DS, ES, FS, GS 
CONTEXT_FLOATING_POINT 0x00000008L Numeric coprocessor state 


Table 99. EXCEPTIONREPORTRECORD Exception Handler Report Record 


Field Name | Offset | Type Description 


ExceptionNum D Exception number 


fHandlerFlags D Exception attributes 


NestedExceptionReportRecord D Preceding exception’s report 
record if nested exception 


ExceptionAddress D Exception address 


cParameters +10 4 D Size of exception specific 
information 

ExceptionInfo +14 10 D Exception specfic 
information 


Table 100. fHandlerFlags Flag Definitions 


Name Bit Mask Description 

0x1 Noncontinuable exception 
EH_UNWINDING Unwind is in progress 
EH_EXIT_UNWIND Exit unwind is in progress 
EH_STACK_INVALID Stack out of limits or unaligned 
EH_NESTED_CALL Nested exception handler call 
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Table 101. EXCEPTIONREGISTRATIONRECORD Exception Handler Registration Record 


Field Name Offset Length Type Description 

prev_structure +0 4 D Previously registered 
exception handler 

ExceptionHandler +4 4 D Exception handler entry 
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point address or -1 if end of 
chain 


3.6 Loader Control Block Reference 
The following control blocks are described in this section: 
3.6.1, “Module Table Entry for OS/2 Warp V3.0” 
3.6.2, “Swappable Module Table Entry for OS/2 Warp V3.0” on page 167 
3.6.3, “Object Table Entry for OS/2 Warp V3.0” on page 169 
3.6.4, “Segment Table Entry for OS/2 Warp V3.0” on page 170 
3.6.5, “Loader Demand Load Data OS/2 Warp V3.0” on page 171 


3.6.1 Module Table Entry for OS/2 Warp V3.0 


For MTE formats for other versions of OS/2 see: 


3.6.1.1, “Module Table Entry for OS/2 V2.11” on page 167 


Pointers 
_mte_h points to the head of the chain of MTEs. 


_global_h points to head of the chain of library module MTEs. 


Locations 
Dynamically allocated from the kernel resident heap except for the two MTEs 
that represent kernel interfaces. 


_DosMosMte locates the MTE in OS2KRNL for DOSCALLS.DLL. 
_VDDModMte locates the MTE in OS2KRNL for MVDM.DLL. 


VM Owner 
Dynamically allocated MTEs have owner ID Idrmte (Oxffa6) 


Format 

Field Name Offset Type Description 

mte_flags2 +0 Ww Module flags 2 

mte_handle +2 Ww the handle for this mte 

mte_link +8 D link to next mte 

mte_flags1 D Module flags 1 

mte_impmodcnt D Num of entries in Imp Mod 
Name Tbl 

+14 Ww file system number for open 

file 

mte_usecnt +16 2 Ww .EXE only - use count 

mte_modname +18 8 B resident module name (zero 
extended) 


Chapter 3. OS/2 System Control Block Reference 165 


Table 102. mte_flags1 Flag Definitions 


Name Bit Mask Description 

NOAUTODS 0x00000000 No Auto DS exists 

SOLO 0x00000001 Auto DS is shared 

INSTLIBINIT 0x00000004 Per-instance Libinit 

GINISETUP 0x00000008 Global Init has been setup 

NOINTERNFIXUPS 0x00000010 internal fixups in .EXE-.DLL applied 
external fixups in .EXE-.DLL applied 

CLASS_PROGRAM 0x00000040 Program class 

CLASS_GLOBAL 0x00000080 Global class 

CLASS_SPECIFIC 0x000000C0 Specific class, as against global 
nonspecific class - all modules 

CLASS_MASK 0x000000C0 

MTEPROCESSED 0x00000100 MTE being loaded 

USED 0x00000200 MTE is referenced - see Idrgc.c 

DOSMOD 0x00000800 set if DOSCALLS 

MTE_MEDIAFIXED 0x00001000 File Media permits discarding 

LDRINVALID 0x00002000 module not loadable 

DEVDRVMOD 0x00004000 device driver module 

LIBRARYMOD 0x00008000 DLL module 

VDDMOD 0x00010000 VDD module 

INGRAPH 0x00040000 In Module Graph - see Idrgc.c 

GINIDONE 0x00080000 Global Init has finished 

MTEADDRALLOCED 0x00100000 Allocate specific or not 

FSHMOD 0x00400000 FS helper MTE 

MTELONGNAMES 0x00800000 Module supports long-names 

MTE_MEDIACONTIG 0x01000000 File Media contiguous memory req 
File Media requires mem below 16M 

MTESWAPONLOAD 0x04000000 make code pages swap on load 

MTEPORTHOLE 0x08000000 porthole module 

MTEMODPROT 0x10000000 Module has shared memory protected 

MTEDLLTERM 0x40000000 Gets instance termination 

MTESYMLOADED 0x80000000 Set if debugger symbols loaded 
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Table 103. mte_flags2 Flag Definitions 


Name Bit Mask 


Description 


MTEFORMATMASK 0x0003 


Module format mask 


MTEFORMATRI1 0x0000 


MTEFORMATNE 0x0001 Module format NE 


MTEFORMATLX 0x0002 


Module format reserved 


Module format LX 


MTEFORMATR2 0x0003 


Module format reserved 


MTESYSTEMDLL 0x0004 


MTELOADORATTACH 0x0008 Module under load or attach - for init 


MTECIRCLEREF 0x0010 


DLL exists in system list 


Module circular reference detection 


MTEFREEFIXUPS 0x0020 


Free system mte’s fixup flag d#98488 


MTEPRELOADED 0x0040 


MTEGETMTEDONE 0x0080 GetMTE already resolved 


MTEPACKSEGDONE 0x0100 


MTE Preload completed 


Segment packed memory allocated 


MTE20LIELIST 0x0200 


Name present in version20 lie list 


MTESYSPROCESSED 0x0400 


MTEDLLONEXTLST 0x1000 DLL has term routine on exit list #74177 
removed - 75809 


System DLL already processed 


3.6.1.1 Module Table Entry for OS/2 V2.11 


Field Name Offset Type Description 

mte_flags2 +0 WwW Module flags 2 

mte_handle +2 WwW the handle for this mte 

mte_modname +8 A resident module name (zero 
extended) 

mte_link D link to next mte 

mte_flags1 D Module flags 1 

D Num of entries in Imp Mod 

Name Tbl 

mte_sfn +18 2 WwW file system number for open 
file 

mte_usecnt +1a 2 Ww .EXE only - use count 


3.6.2 Swappable Module Table Entry for OS/2 Warp V3.0 


Pointers 


MTE field mte_swapmte points to the associated SMTE. 


Locations 


Dynamically allocated from the kernel swappable heap except for the SMTE 
associalted with DOSCALLS.DLL. 
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_DosMosMteSwappable locates the SMTE in OS2KRNL associated with 


DOSCALLS.DLL. 


VM Owner 


Dynamically allocated SMTEs have owner ID Idrmte (Oxffa6) 


Format 

Field Name Offset Length Type Description 

smte_startobj +4 4 D Object # for instruction 
pointer 

smte_eip +8 4 D Extended instruction pointer 

smte_stackobj +C 4 D Object # for stack pointer 

smte_pageshift +14 4 D 

smte_fixupsize +18 4 D Fixup section size 

smte_objtab +1¢c 4 D Object table offset 

smte_objcnt +20 4 D Number of objects in 
module 

smte_objmap 4 Object page map offset 

smte_itermap 4 Object iterated data map 
offset 

smte_rsrctab 4 Offset of Resource Table 

smte_restab 4 Offset of resident name 
table 

smte_enttab 4 D Offset of Entry Table 

smte_fpagetab 4 D Offset of Fixup Page Table 

smte_frectab 4 D Offset of Fixup Record Table 

smte_impmod 4 D Offset of Import Module 
Name Table 

smte_impproc 4 D Offset of Imp Procedure 
Name Tab 

smte_datapage 4 D Offset of Enumerated Data 
Pages 

smte_nrestab +50 4 D Offset of Non-resident 
Names Table 

smte_cbnrestab +54 4 D Size of Non-resident Name 
Table 

smte_autods +58 4 D Object # for automatic data 
object 

smte_debuginfo +5C 4 Offset of the debugging info 

smte_debuglen +60 4 The len of the debug info in 
bytes 

smte_heapsize +64 4 D use for converted 16-bit 


modules 
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Field Name | Offset | Length Type Description 
smte_path +68 4 D full pathname 
smte_semcount +6C 2 Ww Count of threads waiting on 
MTE semaphore. 0 => 
semaphore is free 
smte_semowner +6e 2 Ww Slot number of the owner of 
MTE semahore 
smte_pfilecache +70 4 D Pointer to file cache for 
Dos32CacheModule 
smte_stacksize +74 4 D Thread 1 Stack size from 
the exe header 
smte_alignshift +78 2 WwW use for converted 16-bit 
modules 
smte_NEexpver +7a 2 Ww expver from NE header 
smte_pathlen 2 WwW length of full pathname 
smte_NEexetype +7e 2 WwW exetype from NE header 
smte_csegpack +80 2 WwW count of segs to pack 


3.6.3 Object Table Entry for OS/2 Warp V3.0 


Pointers 


SMTE field smte_objtab points to the associated OTE for 32-bit modules. 


Locations 


Dynamically allocated from the kernel swappable heap except for the SMTE 
associalted with DOSCALLS.DLL. 


dcm_ote_start locates the OTE in OS2KRNL associated with DOSCALLS.DLL. 


VM Owner 


Dynamically allocated OTEs have owner ID Idrmte (Oxffa6) and share the 
same heap block as their SMTE. 


Format 
Field Name Offset Type Description 
ote_size +0 D Object virtual size 
ote_base +4 D Object base virtual address 
ote_pagemap D Object page map index 
ote_mapsize D Num of entries in obj page 

map 

ote_resu Ss 
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Table 104. ote_flags Flag Definitions 


Name Bit Mask Description 
OBJREAD 0x00000001L Readable Object 
OBJWRITE 0x00000002L Writeable Object 
OBJRSRC 0x00000008L Resource Object 
OBJDISCARD 0x00000010L Object is Discardable 
OBJSHARED 0x00000020L Object is Shared 
OBJINVALID 0x00000080L Object has invalid pages 
OBJZEROFIL 0x00000100L Object has zero-filled pages 
OBJRESIDENT 0x00000200L Object is resident 
OBJBIGDEF 0x00002000L Big/Default bit setting 
OBJCONFORM 0x00004000L Object is conforming for code 
OBJIOPL 0x00008000L Object I/O privilege level 

Object is made private for debug (now 

obsolete) 

OBJALLOC 0x80000000L Object is allocated used by loader 


3.6.4 Segment Table Entry for OS/2 Warp V3.0 


Pointers 
SMTE field smte_objtab points to the associated STE for 16-bit modules. 


Locations 
Dynamically allocated from the kernel swappable heap. 


VM Owner 
Dynamically allocated STEs have owner ID Idrmte (Oxffa6) and share the 
same heap block as their SMTE. 


Format 
Type Description 
ste_offset Ww file offset to segment data 
ste_size Ww file data size 
ste_flags Ww type and attribute flags 
WwW minimum allocation size 
ste_seghdl WwW segment handle 
ste_selector WwW segment selector 
ste_fixups D fixup record storage 


170 os/2 Debugging 


Table 105. ste_flags Flag Definitions 


Name 


Bit Mask Description 


STE_TYPE_MASK 


0x0001 segment type field 


STE_CODE 0x0000 code segment type 


STE_DATA 0x0001 data segment type 


STE_PACKED 0x0002 segment is packed 


STE_SEMAPHORE 0x0004 segment semaphore 


STE_ITERATED 0x0008 segment data is iterated 


STE_WAITING 0x0010 segment is waiting on semaphore 


STE_SHARED 0x0020 segment can be shared 


STE_PRELOAD 0x0040 segment is preload 


STE_ERONLY 0x0080 execute only if code segment read only if 
data segment 


STE_RELOCINFO 0x0100 set if segment has reloc records 


STE_CONFORM 0x0200 segment is conforming 


STE_RING_2 0x0800 ring 2 selector 


STE_RING_3 0x0C00 ring 3 selector 


STE_HUGE 0x1000 huge segment 


STE_PAGEABLE 0x2000 just a page can be faulted in 


STE_PRESENT 0x2000 packed segment already loaded 


STE_SELALLOCG 0x4000 used to indicate sel allocated 


STE_GDTSEG 0x8000 used to indicate GTD sel alloc 


3.6.5 Loader Demand Load Data OS/2 Warp V3.0 


Pointers 
PTDA field ptda_pldrdidHead points to chain of modules loaded by 
DosLoadModule for a given process. 


_pldrdidHeadKernel points to the head of kernel reference list of LDRDLDs. 


Locations 
Dynamically allocated from the kernel resident heap. 


VM Owner 
Idrdid (Oxffa4) 


Format 


Field Name Offset Length Type Description 


Idrdid_pldrdidNext +0 4 D Pointer to next Idrdld 
Idrdid_hmte 2 Ww handle of loaded module 
Idrdid_cRef +6 2 Ww Number of times loaded 
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3.7 File System Block Reference 
The following control blocks are described in this section: 
3.7.2, “File System Control Block for OS/2 Warp V3.0” on page 178 
3.7.3, “System File Table Entry for OS/2 Warp V3.0” on page 182 


3.7.4, “Master File Table Entry for OS/2 Warp V3.0 ALLSTRICT Kernel” on 
page 186 


3.7.5, “Record Lock Record for OS/2 Warp V3.0” on page 188 

3.7.6, “Volume Parameter Block for OS/2 Warp V3.0” on page 189 
3.7.7, “Drive Parameter Block for OS/2 Warp V3.0” on page 193 
3.7.8, “Current Directory Structure for OS/2 Warp V3.0” on page 195 
3.7.9, “File System Buffer for OS/2 Warp V3.0” on page 197 

3.7.10, “Named Pipe Structures for OS/2 Warp V3.0” on page 199 
3.7.11, “Anonymous Pipe Structures for OS/2 Warp V3.0” on page 203 


An overview of the file system control blocks is as follows: 


3.7.1 File System Control Block Diagrams 


The following diagrams illustrate the relationships between various file system 
control blocks: 


3.7.1.1, “Open Files - Application to System” on page 173 
3.7.1.2, “Open Files - System View” on page 174 

3.7.1.3, “Open Device - System View” on page 175 
3.7.1.4, “Shared Files with Locked Ranges” on page 176 
3.7.1.5, “Anonymous and Named Pipes” on page 177 
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3.7.1.1 Open Files - Application to System 


Open File — Application to System 


#SFT 
#next | count 
: ree ay SFTs 


SAS File System Section# 


#SFT seg 


Application 


SFT 


DosOpen 


returned JFN of 2 


PTDA 


(#SFT: (8+ (83*SFN)) 


JFN_Table 
($PTDA+JFN Table-ptda_ start) (Default 
JFT) 


JFT 


Risanest fo JFN_pTable 


fo] RJM 28th Aug 95 - fsapp 


Figure 28. Open Files - Application to System 


Chapter 3. OS/2 System Control Block Reference 173 


3.7.1.2 Open Files - System View 


Open File — System View 


SFT | MFT 


“9x 


FSD 


file namgq 


es \ f/ 


Volume 


| 


Label 


DEV 


RJM 28th Aug 95 = fsopen 


Figure 29. Open Files - System View 
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3.7.1.3 Open Device - System View 


Open Device — System View 


SFT MFT 
—— 
— 

7 


DEV 


RJM 28th Aug 95 - fsdev 


Figure 30. Open Device - System View 


Chapter 3. OS/2 System Control Block Reference 175 


3.7.1.4 Shared Files with Locked Ranges 


Shared File with 2 Locked Ranges 


PTDA 
SFT 
< 
SFN 
1 
PID MFT 
PTDA +o (#3 ptr) 
2 
PTDA 


RUM 28th Aug 95 - isshrlk 


Figure 31. Shared Files with Locked Ranges 
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3.7.1.5 Anonymous and Named Pipes 


Anonymous Pipes 
SFT 


IOBLOCK 
sfi_hvPB Pipe Buffer 


Named Pipes 
Pipe Buffer 


NPB 
outgoing a 
SFT 
NP 
sf_Fsc Ont 
SS 


incoming 


Pipe Buffer 
NPB 


RJM 24th Nov 95 - fspipes 


Figure 32. Anonymous and Named Pipes 
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3.7.2 File System Control Block for OS/2 Warp V3.0 


Pointers 
SFT field sf_FSC points to the associated FSC_ENTRY. 


VPB field vpb_FSC points to the associated FSC_ENTRY. 
CDS field cd_ownerFSC points to the associated FSC_ENTRY. 
SAS field SAS_dd_FSC contains the selector for FSCSEG. 
GDT_FSC locates the GDT descriptor for the FSCSEG. 


Locations 
Dynamically allocated from the kernel resident heap. 


VM Owner 
fsc (Oxff95) 


Format 


Table 106. FSCSEG 


Field Name Offset Type Description 

fss_Limit 0 WwW Offset PAST last allocated 
byte 

fss_ShutdownFlags Ww flags for shutdown 

fss_ SDWaitCount 4 WwW number of processes 
pending before 

fss_pad 6 2 Ww shutdown can commence 


(DWORD align) 


Table 107 (Page 1 of 2). FS_ENTRY 


FS_ATTRIBUTE 0 4 D -> FSD attribute. (in FSD 
memory) 

FS_NAME 4 4 D -> FSD name. (in FSD 
memory) 

FS_ATTACH 8 4 D DosQFsAttach, DosFsAttach 

FS_CHGFILEPTR 10 4 D DosChgFilePtr 

FS_ CLOSE 14 4 D DosClose 

FS_COPY 18 4 D DosCopy 

FS_EXIT 20 4 D DosExit 

FS_FILEATTRIBUTE 24 4 D DosFilelnfo, DosSetFileMode 

FS_FILEINFO 28 4 D DosQFilelInfo, DosSetFilelnfo 

FS_FINDCLOSE 30 4 D DosFindClose 

FS_FINDFIRST 34 4 D DosFindFirst 
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Table 107 (Page 2 of 2). FS_ENTRY 


Field Name Offset Length Type Description 
FS_FINDFROMNAME 38 4 D DosFindFromName-Private 
to server 
FS_FINDNEXT 3C 4 D DosFindNext 
4 D DosFindNotifyGlose 
FS_FINDNOTIFYFIRST 44 4 D DosFindNotifyFirst 
FS_FINDNOTIFYNEXT 48 4 D DosFindNotifyNext 
FS_FSINFO 4c 4 D DosQFsInfo, DosSetFsInfo 
FS_IOCTL 54 4 D DosDevloctl 
FS_MKDIR 58 4 D DosMkdir 
FS MOUNT 5C 4 D -- No corresponding API 
FS_NEWSIZE 64 4 D DosNewsize 
FS_NMPIPE 68 4 D All named pipe related API’s 
FS_OPENCREATE 6C 4 D DosOpen 
DosSetPathInfo 
FS_PROCESSNAME 74 4 D -- No corresponding API 
FS_READ 78 4 D DosRead, DosReadAsync 
FS_RMDIR 7C 4 D DosRmdir 
FS_WRITE 84 4 D DosWrite, DosWriteAsync 
FS_OPENPAGEFILE 88 4 D init time only 
FS_ALLOCATEPAGESPACE 8C 4 D size swap file 
| FS_CANCELLOCKREQUEST | 90 | 4 D DosCancelLockRequest 
FS_FILELOCKS 94 4 D DosSetFileLocks 
FS_VERIFYUNCNAME 98 4 D Used to save function 
addresses 
FS_COMMIT 9C 4 D DosBufReset, DosClose 
FS_FSCTL A4 4 D DosFsCtl 
FS_FLUSHBUF A8 4 D DosBufReset 
FS_SHUTDOWN AC 4 D DosShutdown 
toe ie | 4 D Used to save function 
addresses 
FS_SDFSINFO B4 4 D at shutdown time. These 
functions 
FS_SDREAD B8 4 D will only be called by 
shutdown 
FS_SDWRITE BC 4 D filters. 
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Table 108. FS_ATTRIBUTE Flag Definitions 
Name Bit Mask 


Description 


FS_ATTR_REMOTE 0x0001 


local FSD, 1 = remote FSD 


FS_ATTR_UNC 0x0002 


FS_ATTR_LOCKINFO 0x0004 


FS_ATTR_LVL7 0x0008 


= normal, 1 = this is UNC FSD 


= no level 7 requests, 1 = yes 


FS_ATTR_PIPESVR 0x0010 


0 
0 
0 = no notice, 1=notify filelocks 
0 
0 


= don’t FSD on PIPE req,1 = yes 


FS_ATTR_VERNO 0x7000 


FS_ATTR_EA 0x8000 


bits 28-30 version no 


bit 31 -> 1 = extended attribute 


Table 109. FS_COMMIT Flag Definitions 


Name Bit Mask 


FS_COMMIT_ONE 1 


Description 
all handles commit 


one handle commit 


Table 110. Eugates for Close Type 


FS_CL_ORDINARY 


Description 


ordinary close 


FS_CL_FORPROG 


final close for process 


FS_CL_FORSYS 


Table 111. fscnameentstruc 


final close for system 


Offset 


Field Name 


Type Description 


FSCNmEnt_Emulation 


FSCNmEnt_NameLen 


FSCNmEnt_ProcName 


Table 112. mFS_ENTRY 


Field Name Type Description 
MFS_CHGFILEPTR D DosChgFilePtr 
MFS_CLOSE D DosClose 

D -- No corresponding API 
MFS_OPEN D DosOpen 
MFS_READ D DosRead, DosReadAsync 
MFS_TERM D DosRead, DosReadAsync 
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Table 113. uncfscentrstruc 


Field Name Offset Type Description 

UNCfsc_VpbID 0 D Unique ID UNC VPB 

UNCfsc_FSCptr 4 D Hold Seg:ofs to UNC FSD’s 
FSC 

UNCfsc_hVPB Ww Handle to VPB in VPB 
Seg(offset) 

UNCfsc_Active A 2 WwW Does this entry contain UNC 
FSD Info? 

Table 114. uncliststruc 

Field Name | Offset | Length Type Description 

UNCfsc_1 0 Cc B 

UNCfsc_VpbID 0 4 D Unique ID UNC VPB 

UNCfsc_FSCptr 4 4 D Hold Seg:ofs to UNC FSD’s 
FSC 

UNCfsc_hVPB 2 Ww Handle to VPB in VPB 
Seg(offset) 

UNCfsc_Active A 2 Ww Does this entry contain UNC 
FSD Info? 

UNCfsc_2 Cc Cc B 

UNCfsc_VpbID Cc 4 D Unique ID UNC VPB 

UNCfsc_FSCptr 10 4 Hold Seg:ofs to UNC FSD’s 
FSC 

UNCfsc_hVPB 14 2 Ww Handle to VPB in VPB 
Seg(offset) 

UNCfsc_Active 16 2 WwW Does this entry contain UNC 
FSD Info? 

UNCfsc_3 18 Cc 

UNCfsc_VpbID Unique ID UNC VPB 

UNCfsc_FSCptr 1C 4 D Hold Seg:ofs to UNC FSD’s 
FSC 

UNCfsc_hVPB 20 2 Ww Handle to VPB in VPB 
Seg(offset) 

UNCfsc_Active 22 2 Ww Does this entry contain UNC 
FSD Info? 

UNCfsc_VpbID 24 Unique ID UNC VPB 

UNCfsc_FSCptr 28 4 Hold Seg:ofs to UNC FSD’s 
FSC 

UNCfsc_hVPB 2C 2 Ww Handle to VPB in VPB 
Seg/(offset) 

UNCfsc_Active 2E 2 WwW Does this entry contain UNC 
FSD Info? 
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3.7.3 System File Table Entry for OS/2 Warp V3.0 


Pointers 
MFT field mft_sptr points to the associated sf_entry. 


RLR field rlr_sptr points to the associated sf_entry. 

SAS field SAS _ file SFT contains the selector for the SFT segment table. 
NP field np_ssft points to the server SFT for a named pipe. 

NP field np_csft points to the client SFT for a named pipe. 

GDT_SFT locates the GDT descriptor for the SFT segement table. 


Locations 
Dynamically allocated from the system arena. 


VM Owner 
sft (Oxffa1). 


Format 


Table 115. SFT 


Field Name Type Description 

sft_link Ww selector for next chunk of 
table 

sft_count Ww number of entries in this 
block 

sft_handle Ww handle of segment holding 
this block 

sft_inshutdown 6 Ww flags for shutdown 

Table 116 (Page 71 of 3). sf_entry 

Field Name Type Description 

sf_ref_count WwW number of processes 
sharing entry 

sf_usercnt Ww For files: number of threads 
waiting for access to 
sf_entry. For devices: 
number of threads using 
this sf_entry. 

reserved B Used to be attr of file - 
moved to * independent part 
of the SFT for general * 
access 
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Table 116 (Page 2 of 3). sf_entry 
Field Name Offset Length Type Description 


sf_flags 5 2 Ww Bits 8-15 
Bit 15 = 1 if remote file 


= 0 if local file or 
device 


Bit 14 = not used 

Bit 13 = Pipe bit 

Bit 12 = FCB bit 
= 1 if fcb sft 


= 0 if normal sft 

Bit 11 = if Pipe, 
= 0 if anonymous pipe 
= 1 if named pipe 


Bit 10 == sf_inuse = 
sf_entry is in use by some 
thread, ie busy 


Bit 9 == sf_want = some 
thrd blocked waiting to use 
the sf_entry 


Bit 8 == sf_noJFN, no 
handle alloced for sft 


Bits 0-7 (old FCB_devid bits) 
If remote file or local file, bit 


6=0 if dirty Device ID 
number, bits 


0-5 if local file. 
bit 7=0 for local file 
=1 for local I/O device 


If local I/O device, bit 
6=0 if EOF (input) 


Bit 5=1 if Raw mode 


Bit 0=1 if console input 
device 


Bit 1=1 if console output 
device 


Bit 2=1 if null device 


Bit 3=1 if clock device 


De) 
= 


sf_flags2 


sf_devptr 


Not used if local file, points 


II 
KR 
1e) 


sf_FSC 4 Pointer to the file system 
control 
sf_cookie 11 4 D server’s per-file id (for 


oplock support) 
16:16 Link to next SFT 


iN 
iw) 


sf_chain 


15 
sf_MFT 19 4 D 32-bit FLAT pointer to MFT 
entry 
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Table 116 (Page 3 of 3). sf_entry 


Field Name Offset Length Type Description 


sf_fsd 1D 32 Ss 


File system dependent 
section 


sf_fsi 4F 30 Ss 


sf_NmPipeSfn 81 2 Ww 


File system independent 
section 


16-bit offset to first pending 
LOCK record 


SFN of named pipe for 
spooled files 


sf_codepage 83 2 Ww 


current codepage (font) for 
data in file 


sf_LockID 85 4 D 


Table 117. sf_flags Flag Definitions 


lock-id for protected 
file-handle access 


Name Bit Mask 


Description 


SF_ISNET 0x8000 


SF_PIPE 0x2000 


SF_FCB 0x1000 


True if SFT is for remote 
Anonymous Pipe 


True if SFT is for an FCB 


SF_NMPIPE 0x0800 


true if name pipe 


SF_INUSE 0x0400 


SF_BLOCKED 0x0200 


SF_NOJFN 0x0100 


True if sf entry is in use by some thread, 
that is, busy 


True if some thread is blocked waiting to 
use the sf entry 


True if no handle alloc’ed for SFT 


Table 118 (Page 7 of 2). sf_flags2 Flag Definitions 


Description 


True if a format mount was done, and 
still in effect 


True if a beginformat ioctl failed 
“ON’ if SFT owned by some thread 


serving pipe redirection in effect 


A LOCK was issued on this direct access 
handle to lock the drive. 


File is spooled 
Data written to file 


consistency bits 


spool job has been canceled*/ ;whs 


Name Bit Mask 
SF_FORMAT_MOUNT 0x8000 
SF_BEGINFORMAT_FAILED 0x4000 
SF_SRVRDR 0x1000 
SFF2_LOCKED_DRIVE 0x0800 
SFF2_SPOOLED 0x0400 
SFF2_Consistency 0x0180 
SFF2_CANCELJOB 0x0040 
SFF2_NONSPOOLED 0x0020 
sff2_RA_ON 0x0008 


File is nonspooled; going to printer 
SetPathInfo done, don’t set archive 


Readahead started 
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Table 118 (Page 2 of 2). sf_flags2 Flag Definitions 


Name Bit Mask Description 


sff2_UNC 0x0004 UNC object 


sff2_isfree 0x0002 this SFT is on free list (unused) 


sff2_RA_BIG 0x0001 Big Readahead 


Table 119. sfdFATFS 


Field Name Offset Length Type Description 

sfdFAT_firFlLEclus Ww First cluster of file (bit 15 = 
0) 

sfdFAT_cluspos WwW Position of last cluster 
accessed 

sfdFAT_Istclus 2 WwW Last cluster accessed 

sfdFAT_dirsec 4 D Sector # of directory sector 
for this file 

B Offset of this entry in the 

above 

sfdFAT_EAHandle WwW starting cluster of EAs 

sfdFAT_name[11] B B 

sfdFAT_bRAReads 4 D # of consecutive reads 
within range 

sfdFAT_bRABigReads 4 D # of consecutive big reads 

sfdFAT_fldMask 4 D Unique File Dirty Mask 

sfdFAT_pSFT 24 4 D Linear address of SFT 

sfdFAT_ulNextRA 28 4 D Position where next rahead 
starts 

sfdFAT_bBufRun D Number of sectors in rahead 
run 

sfdFAT_LastFATSec Ww last FAT sector added to 
chain 

Table 120. sftfsd 
Description 

sfd_work[50] 

Table 121 (Page 1 of 2). sftsfi 

Type Description 

sfi_mode WwW mode of access or high bit 
on if FCB 

sfi_mode2 WwW additional openmode bits for 
DosOpen2 

sfi_hVPB WwW handle of volume 
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Table 121 (Page 2 of 2). sftsfi 
Field Name Offset Length Type Description 


sfi_cdate 8 2 Ww Creation date of file 


sfi_atime Time of last access of file 


A 2 WwW 
2 WwW 


sfi_mtime Time of last modification of 


m 


file 

sfi_mdate 10 2 Ww Date of last modification of 
file 

sfi_size 4 D Size associated with file 


iN 
iw) 


sfi_position 16 Read/Write pointer or LRU 
count for FCBs 


sfi_UID User ID 


sfi_PID 1c Process ID 


sfi_PDB Process Data Block 


sfi_selfsfn SFN of this sf_entry, used to 
speed 


rm} rm] wm] rm 
=/=/=/= 


sfi_tstamp 1 B update time stamp flags; 
see ST_ equs 

sfi_type 23 2 WwW file/device/named-pipe/FCB 

pPVDBEFil 25 4 D performance counter data 


block pointer 


sfi_DOSattr 29 DOS attributes of 
file(sys,hid,r/o,arch 


= 
is) 


Table 122. sfi_type Flag Definitions 


Name Bit Mask Description 


STYPE_FILE 0x0000 file 


STYPE_DEVICE 0x0001 device 


STYPE_NMPIPE 0x0002 named pipe 


STYPE_FCB 0x0004 SFT is for an FCB 


3.7.4 Master File Table Entry for OS/2 Warp V3.0 ALLSTRICT Kernel 


For MTE formats for other versions of OS/2 see: 


3.7.4.1, “Master File Table Entry for OS/2 Warp V3.0 RETAIL Kernel” on 
page 188 


Pointers 
SFT field sf_MFT points to the associated MFT entry. 


SAS field SAS_file_MFT points to the PTREE head for the MFT PTREE. 


Locations 
Dynamically allocated from the kernel resident heap. 
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VM Owner 
mft (Oxff9e). 


Format 

Field Name Offset Length Type Description 

mft_ksem +0 10 Ss multi read/single write 
semaphore 

mft_Iptr +10 2 Ww 16-bit offset to first LOCK 
record 

mft_sptr +12 4 D 16-bit FAR pointer to first 
SFT in chain 

mft_pCMap +16 4 D 32-bit FLAT pointer to 


cluster map 


mft_CMapKSem +1a 10 Ss semaphore for access to 
pCMap 


mft_opflags +2a 2 Ww oplock flags 

mft_serl +2C 2 Ww serial number for FCB 
checking 

mft_flags +2e 2 WwW general purpose MFT flags 

mft_hvpb +32 2 WwW handle of vpb 

mft_name +34 1 B start of name string (zero 


terminated) 


Table 123. mft_flags Flag Definitions 


Name Bit Mask Description 

mft_pagerheap 0x0001 MFT is allocated on pager heap 

MFT_DEFAULTHEAP 0x0 MFT is allocated on kernel (heap default 
MFT heap) 

Table 124. mft_opflags Flag Definitions 

Name Bit Mask Description 

mft_opnolock 0 no oplock or opbatch on file 

mft_opbatch opbatch on file 

mft_opbreak oplock/batch cleanup in process 

mft_opbreakfailed oplock/batch cleanup failed 
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3.7.4.1 Master File Table Entry for OS/2 Warp V3.0 RETAIL Kernel 


Table 125. Master File Table Entry for OS/2 Warp V3.0 RETAIL Kernel 


Field Name | Offset | Length Type Description 

mft_ksem +0 Cc Ss multi read/single write 
semaphore 

mft_Iptr +C 2 W 16-bit offset to first LOCK 
record 

mft_sptr +e 4 D 16-bit FAR pointer to first 
SFT in chain 

mft_pCMap +12 4 D 32-bit FLAT pointer to 
cluster map 

mft_CMapKSem +16 Cc Ss semaphore for access to 
pCMap 

mft_opflags +22 2 WwW oplock flags 

mft_serl +24 2 Ww serial number for FCB 


checking 


mft_flags 2 Ww general purpose MFT flags 
mft_hvpb +28 2 Ww handle of vpb 
mft_name +2a 1 B start of name string (zero 


terminated) 


3.7.5 Record Lock Record for OS/2 Warp V3.0 


Pointers 
MFT field mft_Iptr contains the offset within the RLR segment to the first RLR 
associated with the MFT. 


GDT_FSC locates the GDT descriptor for the RLR segment. 


Locations 
Dynamically allocated from the system arena. 


VM Owner 
fsreclok (Oxff47). 


Format 
Type Description 

rilr_next Ww 16-bit offset to next RLR. 0 if 
end 

rlr_prev Ww 16-bit offset to prev RLR. 0 
if SFT 

rilr_fba D offset of first byte of locked 
region 

rlr_lba D offset of last byte of locked 
region 
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rlr_sptr D 16:16 FAR pointer to SFT 
rlr_UID Ww lock issuer’s user ID 
rlr_PID Ww lock issuer’s process ID 
WwW lock issuer’s PDB, 0 for 
non-3xBox 
rlr_flags +16 1 B flags 


rir_flags flag definitions 


Table 126. rir_flags Flag Definitions 


Name Bit Mask 


Description 


RLR_EXCLUSIVE 


RLR_SHARED 


RLR_CANCELPLOCK 4 


3.7.6 Volume Parameter Block for OS/2 Warp V3.0 


Pointers 


SFT field sfi_hVPB contains the offset within the VPB segment of the 


associated VPB. 


MFT field mft_hVPB contains the offset within the VPB segment of the 


associated VPB. 


DPB field dpb_hVPB contains the offset within the VPB segment of the 


associated VPB. 


CDS field cdi_hVPB contains the offset within the VPB segment of the 


associated VPB. 


GDT_VPB locates the GDT descriptor for the VPB segment. 


Locations 


VPB segment is dynamically allocated from the kernel resident heap. 


VM Owner 
vpb (0xffa2). 


Format 


vpb 


Table 127 (Page 1 of 2). vpb Format 


Field Name Offset 


Length 


Type 


Description 


vpb_flink 0 


handle of forward link 
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Table 127 (Page 2 of 2). vpb Format 


Offset Length 


Field Name 


Type 


Description 


vpb_blink 


handle of back link 


vpb_ref_count 


vpb_search_count 


count of objects that point 
to VPB 


count of searches that point 
to VPB 


vpb_first_access 1 B initialized to -1 to force a 
media 

vpb_signature 2 WwW Signature specifying VPB 
validity 

vpb_ flags flags (bits 7,6,3-0 defined 
below) 

vpb_fMisc 1 B More flags (bit 7 defined 
below) 


Pointer to the file system 
control block (FSC). 


Table 128. vpb_signature Values 


11 40 Ss File system dependent 
section 
51 2C Ss File system independent 


section 


Name Bit Mask 


Description 


VPB_VALID 


VPB_INVALID 


0x444A 
0x4A47 


Table 129. vpb_ID Values 


Name Bit Mask 


UNREAD_ID1 0x4A52 


UNREAD_|D2 0x534E 


Description 
Media unreadable 


Media unreadable 


DAMAGED_1ID1 0x0000 


Media damaged but recognised by IFS 


DAMAGED_1!D2 0x0000 


Table 130 (Page 7 of 2). vpb_falgs Flag Definitions 


Media damaged but recognised by IFS 


Name Bit Mask 


Description 


0x01 


VPBCHECK 


VPBMOUNT 


a volume ID check is going on for this 
VPB 


new format disk 


Mount in progress 


VPBFORMATMOUNT 


FormatMount done, not cleared 


VPBINVALID 
VPBINITCACHE 
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volume formatted - old vpb invalid 


Initializing Cache Data 


Table 130 (Page 2 of 2). vpb_falgs Flag Definitions 


Name Bit Mask Description 


VPBSETVID 0x40 vid set is in progress 


VPBALLOCATE 0x80 cluster allocation in progress 


Table 131. vpb_fMisc Flag Definitions 


Name Bit Mask Description 


VPB_FM_WRITEABLE 0x01 Set if we know volume can be written 


VPB_FM_UNKNOWN Set if no FATs and not claimed by FSD 


VPB_REMOTE_DRIVE set for attaches of remote drives 


VPB_FM_ALLOCSHWAIT Set if somebody wants alloc access so 
that they can get some disk clusters for 
this volume 


VPB_FM_ALLOCEXWAIT excl.access wait for somebody who wants 
to release some clusters 


VPB_FM_INITCACHE_ERROR Error initializing cache 


VPB_FM_INITCACHE_DONE 0x40 


Table 132. vpbfsd Format 


vpd_work[64] 


Table 133. vpbfsi Table 


Field Name = Length Type Description 
4 D 32-bit unique ID of file (See 
UNREAD_IDx, 
DAMAGED_IDx ) 
vpi_pDPB 4 D Drive volume is in 
vpi_cbSector 2 WwW Size of physical sector in 
bytes 
4 D Total number of sectors on 
medium 
vpi_trksec 2 WwW Sectors per track on 
medium 
vpi_nhead 2 WwW Number of heads in device 
vpi_text[12] Cc B 
vpi_pDCS 4 D device capability struc 
vpi_pVCS 4 D volume characteristic struc 
vpi_drive 26 1 B drive (O=A) 
vpi_unit 1 B unit 
vpi_flags 2 WwW flags for memory 
restrictions 
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Table 134. vpdFATFS Table 


vpdFAT_cNextFreeBitMap 
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i 


Field Name Offset Length Type Description 

vpdFAT_cluster_mask 0 1 B Sectors/cluster - 1 

vpdFAT_cluster_shift 1 1 B Log2 of sectors/cluster 

vpdFAT_first_FAT 2 Ww Starting record of FATs 

vpdFAT_FAT_count 4 1 B Number of FATs for this 
drive 

vpdFAT_root_entries 5 2 Ww Number of directory entries 

vpdFAT_first_sector 7 4 D First sector of first cluster 

vpdFAT_max_cluster 2 Ww Number of clusters on drive 
+ 1 

vpdFAT_FAT_size D 2 WwW Number of records occupied 
by FAT 

vpdFAT_dir_sector F 4 D Starting record of directory 

vpdFAT_media 13 1 B Media byte (duplicate of 
VPB) 

vpdFAT_next_free 14 2 WwW Cluster # of last allocated 
cluster 

vpdFAT_free_cnt 16 2 Ww Count of free clusters, -1 if 
unknown 

vpdFAT_FATentrysize 18 1 B 12 or 16 - can you guess 
why ??? @@ 

vpdFAT_IDsector 19 4 D sector number of ID 

vpdFAT_minEOF 1D 2 WwW minimum EOF cluster value: 
12-bit -> FF8, 16-bit -> 
FFF8 

vpdFAT_access 1F 2 Ww whether rmdir XOR mov dir 
XOR (chdir mkdir OR mov 
file OR create)* has access 
to volume 

vpdFAT_accwait 21 2 Ww who’s waiting for access 

vpdFAT_alloc 23 2 WwW whether disk cluster alloc 
OR release 

vpdFAT_eaflags 2 Ww flags for EA usage 

vpdFAT_eareaders 27 2 WwW number of threads with 
pending reads 

vpdFAT_eawaiters 29 2 WwW number of threads waiting 
to run 

vpdFAT_eahandles 2B 2 WwW number of handles in 
EAOffTable 

vpdFAT_pEASFT 4 D SFT for “EA DATA. SF” 

vpdFAT_pBadSector 31 4 D Ptr for Bad sectors data 

vpdFAT_pClusBitMap 35 4 D Ptr to free cluster bit map 

vpdFAT_pNextFreeBitMap 39 4 D Ptr to next free bit map 
position 

3 2 WwW Count of dwords remaining 


in bit map 


Table 135. vpdFAT_eaflags Flag Definitiions 


Name Bit Mask Description 


eavpb_fileopen 0x0001 the EA file on this volume is open 


eavpb_changing 0x0002 the EA file is changing 


eavpb_dooropen the drive door has been opened 


3.7.7 Drive Parameter Block for OS/2 Warp V3.0 


Pointers 
VPB field vpi_pDPB points to the associated DPB. 


Locations 
DPB segment is dynamically allocated from the kernel resident heap. 


VM Owner 
dpb (0xff96). 


Format 


Table 136. DPB Format 


Field Name | Offset | Length Type Description 

dpb_drive +0 1 B Logical drive # assoc with 
DPB (A=0,B=1.,...) 

dpb_unit +1 1 B Driver unit number of DPB 

dpb_driver_addr +2 4 D Pointer to driver 

dpb_next_dpb +6 4 D Pointer to next Drive 
parameter block 

dpb_cbSector +a 2 Ww sector size (for volume 
checking) 

dpb_first_FAT +C 2 Ww sector of 1st FAT (for 
ancient dev drivers) 

dpb_toggle_time +e 4 D time of last drive toggle 

dpb_hVPB +12 2 Ww handle of volume currently 
in drive 

dpb_media +14 1 B most recent media that was 
in drive 

dpb_flags +15 1 B synchronization flags (see 
below) 

dpb_drive_lock +16 2 Ww Contains pid if drive locked 
by process 

dpb_strategy2 +18 4 D strategy2 addr (or 00000000) 
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Table 137. dpb_flags Flag Definitions 


Name Bit Mask 


Description 


DPBCHECK 0x10 


disk in drive is being removed/checked 
for VPB 


DPBNONREMOV 0x20 


1 => drive supports non-removable 
media 


DPBVGRAMDISK Ram Disk Driver 


Table 138. DPB3X Table 


Field Name eae i Length Type Description 

dpb3x_drive B Logical drive # assoc with 
DPB (A=0,B=1.,...) 

dpb3x_UNIT +1 1 B Driver unit number of DPB 

dpb3x_sector_size +2 2 Ww Size of physical sector in 
bytes 

dpb3x_cluster_mask 1 B Sectors/cluster - 1 

dpb3x_cluster_shift 1 B Log2 of sectors/cluster 

dpb3x_first_FAT +6 2 Ww Starting record of FATs 

dpb3x_FAT_count +8 1 B Number of FATs for this 
drive 

dpb3x_root_entries 2 WwW Number of directory entries 

dpb3x_first_sector 2 Ww First sector of first cluster 

dpb3x_max_cluster +d 2 Ww Number of clusters on drive 
+ 1 

dpb3x_FAT_size +f 1 B Number of records occupied 
by FAT 

dpb3x_dir_sector 2 Ww Starting record of directory 

dpb3x_driver_addr +12 4 D Pointer to driver 

dpb3x_media +16 1 B Media byte 

dpb3x_first_access +17 1 B This is initialized to -1 to 
force a media check the first 
time this DPB is used 

dpb3x_next_dpb 4 D Pointer to next Drive 
parameter block 

dpb3x_next_free 2 Ww Cluster # of last allocated 
cluster 

dpb3x_free_cnt +1e 2 Ww Count of free clusters, -1 if 
unknown 


Table 139 (Page 71 of 2). DPB4X Table 


Field Name Length 


Type Description 


dpb4x_drive 
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B Logical drive # assoc with 
DPB (A=0,B=1.,...) 


Table 139 (Page 2 of 2). DPB4X Table 


Field Name Offset Length Type Description 

dpb4x_UNIT +1 1 B Driver unit number of DPB 

dpb4x_sector_size +2 2 Ww Size of physical sector in 
bytes 

dpb4x_cluster_mask 1 B Sectors/cluster - 1 

dpb4x_cluster_shift +5 1 B Log2 of sectors/cluster 

dpb4x_first_FAT +6 2 Ww Starting record of FATs 

dpb4x_FAT_count +8 1 B Number of FATs for this 
drive 

dpb4x_root_entries 2 Ww Number of directory entries 

dpb4x_first_sector +b 2 WwW First sector of first cluster 

dpb4x_max_cluster +d 2 Ww Number of clusters on drive 
+ 1 

dpb4x_FAT_size +f 2 Ww Number of records occupied 
by FAT 

dpb4x_dir_sector +11 2 Ww Starting record of directory 

dpb4x_driver_addr +13 4 D Pointer to driver 

dpb4x_media +17 1 B Media byte 

dpb4x_first_access +18 1 B This is initialized to -1 to 
force a media check the first 
time this DPB is used 

dpb4x_next_dpb +19 2 D Pointer to next Drive 
parameter block 

dpb4x_next_free +1d 2 Ww Cluster # of last allocated 
cluster 

dpb4x_free_cnt +1f 2 Ww Count of free clusters, -1 if 


unknown 


3.7.8 Current Directory Structure for OS/2 Warp V3.0 


Pointers 


SAS field SAS_file CDS contains the selector for CDS RMP segment. 


CDSAddr locates the RMP handle which contains the selector for the CDS 


RMP segment. 


Locations 


CDS segment is dynamically allocated from the kernel resident heap. 


VM Owner 


cdsrmp (Oxff61). 


Format 
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Table 140. cddFATFS Table 


Field Name Offset Length Type Description 
cddFAT_id 0 2 Ww cluster of current dir 
Table 141. cdfsd Table 
Field Name Offset Length Type Description 
cdd_work[8] 0 8 Ss 
Table 142. cdfsi Table 
Field Name Offset Type Description 
cdi_hVPB 0 Ww hVPB for the drive mapped 
to this CDS 
cdi_end Ww End of assignment 
B fs independent flags (see 
below) 
cdi_text[260] 5 104 A 
Table 143. curdir Table 
cd_handle 2 WwW lookup key for this CDS 
cd_pid 2 Ww PID part of lockup key for 
handles 1-26 
cd_refcnt 2 Ww reference count CDSs 
1 B See below for definitions 
cd_devptr 4 D local pointer to DPB or net 
device 
cd_OwnerFSC 2 Ww Owner FSC.Offst 
cd_fsd 8 Ss File system dependent 
section 
10A Ss File system independent 
section 
cdi_hVPB 2 Ww hVPB for the drive mapped 
to this CDS 
cdi_end 17 2 Ww End of assignment 
cdi_flags 19 1 B fs independent flags (see 
below) 
11E B 


Table 144 (Page 1 of 2). cd_flags Flag Definitions 


CD_ISNET 0x80 


Description 


This CDS is for a remote drive 
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Table 144 (Page 2 of 2). cd_flags Flag Definitions 


Name Bit Mask Description 

CD_INUSE 0x40 This CDS is in use 

CD_SPLICE 0x20 This CDS is for a JOINed drive 
CD_JOIN This CDS is for a JOINed drive 
CD_LOCAL 0x10 This CDS is for a SUBSTed drive 
CD_ISPSEUDOCHAR 0x08 This CDS for a pseudo-char dev 


CD_ISUNC 0x04 This CDS for a UNC name 


Table 145. cdi_flags Flag Definitions 


Description 
CDI_ISVALID This CDS contains a valid cd_fsd 
CDI_ISROOT This CDS is for a root (no cdfsd) 
CDI_MEDIASWAPPED This CDS may not be valid (forces 
3.7.9 File System Buffer for OS/2 Warp V3.0 
Pointers 
SAS field SAS _file_Buffers contains the selector for the file system buffer 
segment. 


GDT_Buffers locates the GDT descriptor for the BUFSEG segment. 


Locations 
BUFSEG segment is dynamically allocated from the kernel resident heap. 


VM Owner 
fsbuf (Oxff93). 


Format 


Table 146 (Page 1 of 2). BUFSEG Format 


Field Name Type Description 

bs_MRUHead Ww Head of MRU buffer list 
(LRU tail) 

bs_MRUTail WwW Tail of MRU buffer list (LRU 
head) 

bs_FreeHead Ww Head of Free buffer list 

bs_Handle +6 2 Ww Handle for virtual memory 
manager 
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Table 146 (Page 2 of 2). BUFSEG Format 


Field Name Offset Length Type Description 

bs_nBuffers +8 2 Ww Number of buffers in 
segment 

bs_buffsize +a 2 WwW Size of buffer+header, in 
bytes. 

bs_seglimit +C 2 WwW Limit for entire buffer 
segment. 

bs_pStats +e 2 WwW Offset of statistics block (for 
PROFILE) 

bs_offRemMed +10 2 Ww Minimum “legal” offset of 
buffer for removable media 

bs_MaxSec +12 2 Ww Maximum sector size for 
block device drivers 

bs_BigBufBase 2 WwW Base of big buffers pool 

bs_BigBufMap +16 2 WwW Big buffers usage bit map 
(bitO - BufO) 

bs_physBufSeg +18 4 D Buffer segment Physical 
Address 

Table 147. BUFFINFO Format 

Field Name Offset Length Type Description 

buf_next +0 2 Ww Pointer to next buffer in list 
(-1 = end) 

buf_prev +2 2 Ww Pointer to previous buffer in 
list (-1 = end) 

buf_freeLink +4 2 Ww Pointer to next free buffer 
(-1 = end) 

buf_hVPB +6 1 Ww serial number of volume 

buf_wrtcnt +C 1 B For FAT sectors, # times 
sector written out 

buf_wrtcntinc +d 2 WwW For FAT sectors, # sectors 
between each write 

buf_flags +f 1 B Flags 

buf_tid 2 Ww thread ID of buffer owner 

buf_refent 2 Ww number of threads using 
buffer for read 

buf_fill 2 WwW random debugging 
information 

buf_pad 2 WwW Force dword alignment. 
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Table 148. buf_falgs Flag Definitions 


Name Bit Mask Description 
1 if buffer dirty 


BUF_DIRTY 0x80 Bit 7 


1 if buffer seen in search 


BUF_VISIT 0x40 Bit 6 
BUF_BUSY Bit 4 
BUF_ISDATA Bit 3 
BUF_ISDIR Bit 2 = 1 if buffer is DIR 


BUF_ISFAT Bit 1 = 1 if buffer is FAT 


BUF_ATTEMPTING_READ 0x01 Bit 0 = 1 if buffer is in swapper pool 


1 if process waiting for buffer 


1 if in use by process 


1 if buffer is DATA 


3.7.10 Named Pipe Structures for OS/2 Warp V3.0 


Pointers 
SFT field sf_fsd points to the associated NP structure. 


NmpRmpHand locates the RMP handle that contains the selector for the NPN 
RMP segment. 


NPN field npn_link points to the list of linked NP structures. 


NP fields np_selector1 and np_selector2 point to associated NPB structures. 


Locations 
The NPN RMP is allocated from the kernel swappable heap. 


The NP is allocated from the system arena. 


The NPB is allocated from the kernel resident heap. 


VM Owner 
NP owner ID is npipenp (O0xff31). 


NPN owner ID is npipenpn (0xff30). 
NPB owner ID is npipenbuf (Oxff9f). 


Format 


There are four important data structures associated with named pipes: the SFT 
corresponding to an open named pipe, a pair of kernel internal data structures 

describing the pipe and one or two allocated memory segments which contain 

the data buffers for the pipe. 


The parts of the SFT specific to named pipes are: 


sf_flags SF_NMPIPE and SF_PIPE set 
sf_np pointer to pipe info. 
sf_pipmod mode of pipe, per-sft internal state bits 
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Where: 


sf_np is defined to be sf_fsd+0, the pointer to np structure 
sf_pipmod is defined to be sf_fsd+4, the mode of pipe, plus internal state 


NP Named Pipe data structure 


The internal data structure for an instance of a pipe. One of these structures is 
allocated for each open instance of a particular named pipe. 


Allocated NP structures are placed on two lists. The first is headed by 
ActiveNPList, with list pointer np_next linking together all currently active NP 
structures. 


The second list is headed by the NPN structure defined below and is 
doubly-linked by the np_flink and np_blink pointers. This list is used to iterate 
over all instances of a particular pipe name. 


Field Name Offset Length Type Description 
np_refcnt 1 B SFT reference count for pipe 
(1 or 2) 
np_next 2 Ww pointer to next in active list 
np_flink 2 Ww pointer to next instance of 
pipe 
2 WwW pointer to previous instance 
of pipe 
np_namkey 2 WwW RMP key value for npn 
structure 
np_scnt 1 B count of servers (max. 1) 
np_ccnt 1 B count of clients (max. 1) 
2 Ww selector for outgoing data 
buffer 
np_selector2 2 Ww selector for incoming data 
buffer 
np_pipmod 2 WwW pipe mode specified at 
creation time 
np_flags 2 Ww pipe flags 
4 D back pointer to server SFT 
np_csft 4 D back pointer to client SFT 
np_timeo 4 D default timeout for 
DosWaitNmPipe 
np_ssem 4 D server end system 
semaphore 
np_csem +26 4 D client end system 
semaphore 
np_csemkey +2a 2 WwW client’s semaphore key 
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NPN Named Pipe Name data structure 


The following structure contains the common name for the multiple instances of 
a pipe. Its key value is used as the ProcBlock key for waiters on the pipe. The 
key value is also used as an RMP key to look up the name record from the NP 


structure. 
Field Name Offset Length Type Description 
npn_key WwW unique serial number of 
name 
npn_len Ww total length of structure 
npn_name A name of pipe, null 
terminated 


NPB Named Pipe Buffer data structure 


The following variables are used to control the access to a pipe buffer and are 
part of the allocated buffer for the pipe. In the case of a duplex pipe, two 
independent data buffers are allocated. Only one buffer will be allocated for a 
simplex pipe. 


npb_selector 2 selector of buffer 
npb_first 2 Ww base of buffer 
npb_in 2 Ww next free byte in buffer 

2 Ww next byte of data in buffer 
npb_last 2 Ww end+1 of buffer 
npb_rdick 2 Ww read lock sem. 
npb_wtlck 2 Ww write lock sem. 

2 Ww read sync sem. 
npb_wtsem 2 Ww write sync sem. 
npb_rdcnt 1 B count of readers of buffer 
npb_wtcnt 1 B count of writers to buffer 

2 WwW size of data left in pipe 


np_state allowable values for named pipe state 


Internally, byte stream mode pipes store only a collection of bytes in the data 
buffer. Message stream mode pipes have individual messages preceeded by a 
word which indicates the size of the message. 
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NP_DISCONNECTED 


Named pipes may be in one of several states depending on the actions that have 
been taken on it by the server end and client end. The following state/action 
table summarizes the valid state transitions: 


Current state Action Next state 

<none> server MakeNmPipe DISCONNECTED 
DISCONNECTED server connect LISTENING 
LISTENING client open CONNECTED 
CONNECTED server disconn DISCONNECTED 
CONNECTED client close CLOSING 

CLOSING server disconn DISCONNECTED 
CONNECTED server close CLOSING 

<any other> server close <pipe deal located> 


A special internal state LISTEN2 is used when a client open is in progress (since 
some operations may block). This is treated the same as the LISTENING state 
except that a new open or wait will not recognize it as an available pipe. 


If a server disconnects its end of the pipe, the client end will enter a special 
state in which any future operations (except close) on the file descriptor 
associated with the pipe will return an error. 


Description 


after pipe creation or Disconnect 


NP_LISTENING 


after DosNmPipeConnect 


NP_CONNECTED 


after Client open 


NP_CLOSING after Client close 


NP_LISTEN2 


0x12 internal; client open in progress 


Name 


np_pipmod, sf_pipmod bit mask values: 


Bit Mask Description 


NP_NBLK 


0x8000 non-blocking read/write 


NP_NBLKR 


0x8000 non-blocking read 


NP_NBLKW 0x8000 non-blocking write 


NP_SERVER 


0x4000 set if server end 


NP_WMESG 


0x0400 write messages 


NP_RMESG 
NP_TIMOUT 
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0x0100 read as messages 


0x3800 Timeout np_sem_blk and np_sem_wait 


3.7.11. Anonymous Pipe Structures for OS/2 Warp V3.0 


Pointers 
SFT field sfi_hVPB contains the selector that maps I|OBLOCK structure. 


Locations 
The pipe IOBLOCK is allocated from the kernel heaps. 


VM Owner 
pipe (Oxffa0). 


Format 


IOBLOCK Anonymous Pipe data structure 


A pipe is a connection between (among) file handles (JFNs). Data written to the 
write end of the pipe are made available for reading on the read end. The $Pipe 
system call creates a pipe and returns two file handles, one for the read end and 
one for the write end. These handles are manipulated in the same way as 
normal file handles; they may be ’dup’ed and are inherited in the same way. 
Data are written into a pipe via a write system call on the write end of the pipe. 
Likewise, data are read from the pipe via a read call on the read end. 


Data that are written to a pipe are captured in a circular buffer. The size of the 
buffer is specified when the pipe is created; if no size is specified, a default size 
is used. 


The circular buffer is described by an joblock. The ioblock is the buffer’s header; 
the circular buffer proper follows the ioblock in a heap memory object (mapped 
by a GDT selector) allocated when the pipe is created. The ioblock contains all 
of the per-pipe information, such as reader, writer, and reference counts, and 
also holds the pointers into the circular buffer proper. 


The selector that points to the circular buffer is stored in the SFT, at sfi_hVPB. 


* 


When the in and out pointers are equal, the circular buffer is empty. When the in 
pointer trails the out pointer by 1, the buffer is full. Thus, a 512 byte buffer can 
hold only 511 bytes; one byte is lost so that full and empty conditions can be 
distinguished. In order for the user to be able to put 512 bytes in a pipe that 
they created with a size of 512, we allow for this byte loss when allocating the 
segment. 


Field Name Offset Length Type Description 

io_inprogcnt +0 1 B count of read/wrts in 
progress 

io_refent 1 B count of references 

io_rdrent 1 B count of readers 

io_wtrcent 1 B count of writers 

io_selector 2 Ww buffer selector 

io_first 2 WwW ptr to base of circular buffer 
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Field Name Type Description 


ptr to next free byte 


ptr to next byte of data 


ptr to end+1 of buffer 


read lock semaphore 


+a 
+C 


io_wtlksem +10 


write lock semaphore 


io_rdsem +12 read sync semaphore 


=/=/2/=/=/=/= 


io_wtsem +14 write sync semaphore 
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3.8 I/O System Control Block Reference 
The following control blocks are described in this section: 


3.8.2, “Physical Device Driver Header (DEV) for OS/2 Warp V3.0” on 
page 209 


3.8.3, “PDD IQR Information Blocks (DIRQ) for OS/2 Warp V3.0” on page 210 
3.8.4, “Virtual Device Driver Entry Point Structures” on page 211 


3.8.5, “Device Driver (Strategy 1) Request Packet (REQ) for OS/2 Warp V3.0” 
on page 213 


3.8.6, “BIOS Parameter Block (BPB) for OS/2 Warp V3.0” on page 215 


An overview of the I/O system control blocks is as follows: 


3.8.1 I/O System Control Block Diagrams 


The following diagrams illustrate the relationships between various I/O system 
control blocks: 


3.8.1.1, “Physical Device Driver Communication” on page 206 
3.8.1.2, “Physical Device Driver IRQ Sharing” on page 207 


3.8.1.3, “Virtual Device Driver Communication” on page 208 
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3.8.1.1. Physical Device Driver Communication 


Physical Device Driver Communication 


Sas 


SAS device driver section 


PDD/VDD ep 


_ppddephead 


PDDEP 


Registered Name 


Figure 33. Physical Device Driver Communication 
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3.8.1.2 Physical Device Driver IRQ Sharing 


Physical Device Driver IRQ Sharing 


IRQI array 


PDD1 


Interrupt 
entry pt 


Interrupt 


entry pt 


RJM 24th Nov 95 - ioirq 


Figure 34. Physical Device Driver IRQ Sharing 
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3.8.1.3 Virtual Device Driver Communication 


Virtual Device Driver Communication 


HDLVDD VDDPROC VDD 


—, > 
VDD/App ep 


VDD 


VDDs registering same name 


_pvddephead 


VDDEP 


Registered Name 


RJM 24th Nov 965 - iovddep 


Figure 35. Virtual Device Driver Communication 
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3.8.2 Physical Device Driver Header (DEV) for OS/2 Warp V3.0 


Pointers 
DPB field dpb_driver_addr points to the associated Physical Device Driver 
Header. 


SFT field sf_devptr points to the associated Physical Device Driver Header. 


Locations 
Built at the beginning of the first module segment of the device driver. 


VM Owner 
dd1 (Oxff50) to dd16 (Oxff5f). 


Format 

Field Name Offset Length Type Description 

SDevNext +0 4 D Pointer to next device 
header 

SDevAtt 2 W Attributes of the device 

SDevStrat +6 2 WwW Strategy entry point 

SDeviInt +8 2 Ww IDC entry point 

SDevName +a 8 A name (block uses only 1st 
byte) 

SDevProtCS +12 2 WwW Protect-mode CS of strategy 
entry pt 

SDevProtDS +14 2 WwW Protect-mode DS 

SDevRealCS +16 2 WwW Real-mode CS of strategy 
entry pt 

SDevRealDS +18 2 W Real-mode DS 

SDevCaps +20 4 D bit map of DD /MM 
restrictions 


Table 149. SDevCaps Flag Definitions 


Name Bit Mask Description 

DEV_IOCTL2 0x0001 DD can handle dev ioctl2 

DEV_16MB 0x0002 DD can handle phys.addresses >16MB 
DEV_ADAPTER_DD 0x0008 DD supports Adapter Dev Driver Intf 
DEV_INITCOMPLETE 0x0010 DD can handle CMDInitComplete 
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Table 150. Device Driver Type defininitions 


Name Bit Mask Description 
DEV_CIN 0x0001 0 2 5 Device is console in 
DEV_COUT 0x0002 1 2 5 Device is console out 
DEV_CLOCK 0x0008 3 2 5 Device is the clock device 
DEV_SPEC 0x0010 4 2 Devices can support INT 29h 
DEV_ADD_ON 0x0020 5 Device is add-on driver (BWS) 
6 3 Device supports generic ioctl 
DEV_FCNLEV 0x0380 9-7 5 Device function level 
DEV_30 0x0800 11 2 5 Accepts Open/Close/Removable 
Media 
DEV_SHARE 0x1000 12 Device wants FS sharing checking 
13 2 5 Device is a non IBM device. 
DEV_IOCTL 0x4000 14 2 Device accepts IOCTL request 
DEV_CHAR_DEV 0x8000 15 2 5 Device is a character device 


Table 151. Level Definitions for Devices 


Bit Mask 


Description 


Name 


DEVLEV_0 0x0000 DOS 3.0 and before 
DEVLEV_1 0x0080 


0x0100 
0x0180 


DEVLEV_2 OS/2 V1.2 (new gen ioctl iface) 


DEVLEV_3 


OS/2 V2.0 (support of memory above 
16MB) 


3.8.3. PDD IQR Information Blocks (DIRQ) for OS/2 Warp V3.0 


Pointers 
IRQI field irqi_pdirqHead points to the head of a chain of associated DIRQs. 


Locations 
airqi locates the table of IRQI entries. 


DIRQs are allocated dynamically from the kernel resident heap. 


The IRQI array is a static part of the OS2KRNL load module. 


VM Owner 
DIRQI owner id: intdirq (Oxff78). 


Format 
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Table 152. IRQI Table 


Field Name Offset Type Description 
irqi_pdirqHead +0 D Head of shared DD chain (0 
= not set) 

irqi_usIRQNum WwW IRQ number 

WwW IRQ Flags 
Table 153. irqgi_usFlags Flag Definitions 

Description 
0x0003 reserved 

irqf_fVDM 0x0004 If set, this IRQ is a candidate for routing 


to a VDM, if it is not claimed by a PDD 


irqf_fNPX 0x0008 If set, the IRQ is the NPX interrupt level 


irqf_fSharing 0x0010 If set, the IRQ is sharable. If clear the 
IRQ can not be shared by DD. 


irqf_fSys 0x0020 If set, the IRQ is owned by the system 
and the handler can not be changed or 
removed by a device driver. Set initially 
for the slave, IRQ 2. 


irqf_fShared 0x0040 If set, the IRQ can be shared by more 
than 1 DD. This bit reflects the shared 
parameter of the first dh_SetIRQ issued 
for this level. 


Table 154. DIRQ Table 


Field Name Type Description 


dirq_pdirqLink D Next DIRQ structure in list 


dirq_usDS 
dirq_usIRQNum 


DD’s interrupt handler 
DD’s data segment 


IRQ number 


ols|s]lo 


list of unset DIRQs 


dirq_pdirqFreeList 


3.8.4 Virtual Device Driver Entry Point Structures 


Pointers 
_pvddepHead points to the head of a chain of VDDEP structres. One is 
allocated for each VDD that register either or both of a VDD/VDD or VDD/OS2 
entry point. There entry points are used respectively when either a 
VDHRequestVDD/VDHOpenVDD or DosRequestVDD/DosOpenVDD call is 
made. 
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VDDEP field vddep_vddp points to the associated chain of VDDPROC 
structures. One is allocated for each VDD that registers entry points under 


the same name. 


_phdiVddHead points to the head of a chain of HDLVDD structures. One is 
allocated for each open VDD. The handle returned is the address of the 


associated HDLVDD. 


_ppddephead points to the head of a chain of PDDEP structures. One is 
allocated for each Physical Device Driver that registers an entry point for 
VDD/PDD communication. The entry point is registered using 
DevHlIp_RegisterPDD, and accessed using VDHRequestPDD. 


Locations 
VDDEPs, VDDPROCs, HDLVDDs and PDDEPs are allocated dynamically from 


VM 


the kernel resident heap. 


Owner 
VDDEP owner ID: vddep (Oxffd2). 


VDDPROC owner ID: vddproc (0xffdb). 
HDLVDD owner ID: vddir (Oxffd7). 
PDDEP owner ID: vddpddep (0xffda). 


Format 


Table 155. VDDEP Format 


Field Name 


Offset Type 


Description 


vddep_szVDD 


abacabal : 


+0 A 


VDD Name 


VDD entry points (pointer to 
VDDPROC) 


vddep_hmte +d 4 D VDD hmte for deregistering 
if VDD fails 
vddep_pvddep +11 4 D Next VDD (pointer to next 


VDDEP) 


Table 156. VDDPROC Table 


Field Name 


Offset Type 


Description 


vddproc_pfnvdd 


pvddproc 


+0 D 


+4 4 D 


Entry point for VDD/VDD 
comm. 


Entry point for OS2/VDD 
comm. 


Entry points registered with 
same name 
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Table 157. HDLVDD Table 


Field Name Offset Type Description 

hdlvdd_pvddproc +0 D VDD routine to be called 
(pointer to VDDPROC) 

hdlvdd +4 D Pointer to next VDD handle; 
NULL if no more 

Table 158. PDDEP Table 

Field Name Offset Length Type Description 

pddep_fpfn +9 4 D Entry point routine 

pddep_ppddep +d 4 D Next entry point (PDDEP) 


3.8.5 Device Driver (Strategy 1) Request Packet (REQ) for OS/2 Warp V3.0 


Pointers 
TCB field TCBReqPkt points to the Request Packet pre-allocated to a thread. 


Locations 
Allocated from the Request Packet Pool in the System Arena. 


VM Owner 
reqpkt1 (Oxff40). 


Format 
Field Name Offset Length Type Description 
Packet +0 20 Ss Device Driver Request 
Packet 
1 B length in bytes of packet 
PktUnit +1 1 B subunit number of block 
device 
PktCmd +2 1 B command code 
PktStatus +3 2 Ww status word 
1 B disk driver internal flags 
+6 3 B reserved 
PktDOSLink +5 4 D 
PktDevLink +9 4 D device multiple-request link 
18 Ss data pertaining to specific 
packet 
+d 10 iS) Generic IOCTL 
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Type Description 
GlOCategory B Category Code 
GlOFunction B Function code 
GlOParaPack D pointer to parameter packet 
D pointer to data packet 
GIOSFN Ww (used by Spooler?) 
GlOParaLen Ww length of parameter packet 
GlODataLen WwW length of data packet 
iS) INIT Command for Base DDs 
(0 and 27) 
InitcUnit B number of units returned 
InitpEnd pointer to free mem after 
dev 
InitDevHIp D address of Device Helper 
router 
2 Ww size of code segment 
InitEdata 2 Ww size of data segment 
InitParms 4 D pointer parameters 
InitpBPB 4 D pointer to BPBs 
1 B drive no. assigned to unit 0 
1 B reserved 
InitSysiData (for resident 1 B SysInit’s DOSALIAS selector 
drivers only) 
Ss query for extended 
capability command (0x1d) 
3 B reserved 
DCS_Addr 4 Ww 16:16 of driver caps struc 
VCS_Addr 4 Ww 16:16 of volume char struc 
6 B Media Check command 1 
1 B last media byte seen 
MedChkflaga 1 B -1=change O=dont know 
1=no change 
MedChkpVIDa D pointer to VID 
Ss build BPB command 2 
B media byte 
BIldBPBbuffer D scratch buffer 
S) Read/Write 1|O commands 3, 
4, 8, 9, 12, 24, 25, 26 
lOmedia B media byte 
4 D transfer address 
l!Ocount 2 Ww count of bytes/sectors 
lOstart 2 WwW starting sector (block) 
lOPhysRBA 4 D physical starting sector 
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Field Name | Offset | Length Type Description 
PktAdvise 2 WwW for >= vi2 only 
4 Ss Device Open/Close 
commands 13 and 14 
2 Ww sfn of open instance for 
virtualization 
1 Ss Start/Stop console 
commands (98, 99) 
CStpSKG 1 Screen/Keyboard number 
+d 6 Ss De-install driver command 
20 
DINEndLocn +d 4 D 
DINLengthn +11 2 Ww 


Table 159. PktStatus Word Masks 


Name Bit Mask Description 

STERR 0x8000 Bit 15 - Error 

STINTER 0x0400 Bit 10 - Interim character 
Bit 9 - Busy 

STDON 0x0100 Bit 8 - Done 

STECODE OxOOff Error code 

WRECODE 0 

Table 160. PktFlag Flags 

Name Flag value Description 


fPktInt13RP Int 13 Request Packet 


fPktCallOutDone 0x02 


Int 13 Callout completed 


fPktDisklOTchd 0x04 


Disk_IO has touched this packet 


STDON 0x0100 


Bit 8 - Done 


STECODE OxOOff Error code 


WRECODE 0 


3.8.6 BIOS Parameter Block (BPB) for OS/2 Warp V3.0 


Pointers 


I/O Request Packet fields InitpBPB and BIdBPBbuffer point to the BPB 


structure. 
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Locations 
Allocated from the System Arena. 


VM Owner 
Non-specific. 


Format 


Table 161. BPB Format 


Field Name 


BPSECSZ 


Length Type Description 


2 Ww Size in bytes of physical 
sector 


BPCLUS Sectors/Alloc unit 


BPRES 


BPFTCNT 


BPRDCNT 


Number of reserved sectors 


Number of FATs 


BPSCCNT 


= 


B 

Ww 

B 

Ww Number of directory entries 
WwW Total number of sectors 

BPMEDIA B Media descriptor byte 

WwW 


De) 
= 


BPBSecPerTrack sectors per track 


BPBcHeads 


De) 
= 


number of heads 


BPBcSecHidden 


ro 
= 


number of hidden sectors 
before the reserved sectors 


De} 
= 


High word of hidden sectors 


| Offset | 
0 
2 
3 
6 
8 
a 

pee el 2 Number of sectors taken up 
by one FAT 

d 
f 
11 

pis 


BPBcSecHiddenH 13 


BPBcSectTotal 15 4 D Big total sectors (if 
BPSCCNT = 0) 

PHYDRV 19 1 B PHYSICAL DRIVE NUMBER 
(0 OR 80H) 

CURHD la 1 B Unitialized 
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Chapter 4. Reference Tables 


The following reference information is tabulated in this section: 
4.1, “System Error Codes” 
4.2, “OS/2 System Exception Codes” on page 237 
4.3, “Trap Screen Reference” on page 241 
4.4, “Standard GDT Assignments” on page 245 
4.5, “Standard LDT Assignments” on page 248 
4.6, “VM System Object Owner IDs” on page 249 
4.7, “DevHlp Function Cross-Reference” on page 255 
4.8, “System Ordinal Cross-Reference” on page 257 
4.9, “OS/2 FixPak to Build Level Cross-Reference” on page 280 


4.1 System Error Codes 
OS/2 System Error Codes 


Table 162 (Page 1 of 19). OS/2 System Error Codes 

Code Description 

NO ERROR 

INVALID FUNCTION 
FILE NOT FOUND 

PATH NOT FOUND 

TOO MANY OPEN FILES 
ACCESS DENIED 
INVALID HANDLE 
ARENA TRASHED 

NOT ENOUGH MEMORY 
INVALID BLOCK 

BAD ENVIRONMENT 
BAD FORMAT 

INVALID ACCESS 
INVALID DATA 


— 
= 


INVALID DRIVE 
CURRENT DIRECTORY 
NOT SAME DEVICE 
NO MORE FILES 
WRITE PROTECT 

BAD UNIT 

NOT READY 


no 
Oo 


2a/o2/a];/2]/-];]=- =/|olaol/nil[oa}lalaAlolrm}Aajto 
ololniloala|wlnr ° 


ye) 
=e 
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Table 162 (Page 2 of 19). OS/2 System Error Codes 


Code Description 

22 BAD COMMAND 

23 CRC 

25 SEEK 

26 NOT DOS DISK 

27 SECTOR NOT FOUND 


to 
[oe] 


OUT OF PAPER 


29 WRITE FAULT 
30 READ FAULT 
GEN FAILURE 


| 
Po] — 


SHARING VIOLATION 


33 LOCK VIOLATION 
34 WRONG DISK 
35 FCB UNAVAILABLE 


o 
(o>) 


SHARING BUFFER EXCEEDED 


37 CODE PAGE MISMATCHED 
38 HANDLE EOF 
39 HANDLE DISK FULL 


| 
Oo 


BAD COMMAND 


41 CRC 
42 BAD LENGTH 
43 SEEK 


aN 
AK 


NOT DOS DISK 


45 SECTOR NOT FOUND 
46 OUT OF PAPER 

47 WRITE FAULT 

49 GEN FAILURE 


NOT SUPPORTED 


REM NOT LIST 
DUP NAME 
BAD NETPATH 


NETWORK BUSY 


DEV NOT EXIST 
TOO MANY CMDS 
ADAP HDW ERR 


BAD NET RESP 


ala; ara; als; al! a;yas;as a 
O;}/MDI NI nI al; eR]w]nrm]s]-+-|]o 


(o>) 
= 


UNEXP NET ERR 
BAD REM ADAP 
PRINTQ FULL 


Nh 
—_ 
foe) 
e) 
n 
me 
iN) 
is) 
ro 
og 
= 
a 
rr) 
5 
a 


Table 162 (Page 3 of 19). OS/2 System Error Codes 


Code 


Description 


NO SPOOL SPACE 


PRINT CANCELLED 
NETNAME DELETED 
NETWORK ACCESS DENIED 


BAD DEV TYPE 


DIDI DID] OD] DD 
i 


(o>) 
o 


BAD NET NAME 
TOO MANY NAMES 
TOO MANY SESS 


N 
Oo 


SHARING PAUSED 


N 
_e 


N 
ye) 


N 
(oe) 


REQ NOT ACCEP 
REDIR PAUSED 
SBCS ATT WRITE PROT 


N 
aN 


SBCS GENERAL FAILURE 


N 
oa 


XGA OUT MEMORY 
FILE EXISTS 
DUP FCB 


CANNOT MAKE 


FAIL 124 
OUT OF STRUCTURES 
ALREADY ASSIGNED 


INVALID PASSWORD 


INVALID PARAMETER 
NET WRITE FAULT 
NO PROC SLOTS 


NOT FROZEN 


SYS COMP NOT LOADED 
ERR TSTOVFL 
ERR TSTDUP 


NO ITEMS 


o o}o;]aoa;osl]o}] ot} oo] ao} o@ |] oO] ©] ©] C&}] ©] 
o a;lwls/nmnsl-flo;}o};]ol;yaorlirnNns as aye] o]pmy] = 


INTERRUPT 
INVALID DTA 
DEVICE IN USE 


100 


TOO MANY SEMAPHORES 


101 
102 


EXCL SEM ALREADY OWNED 
SEM IS SET 


103 TOO MANY SEM REQUESTS 
104 INVALID AT INTERRUPT TIME 
105 SEM OWNER DIED 


106 
107 


SEM USER LIMIT 
DISK CHANGE 
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Table 162 (Page 4 of 19). OS/2 System Error Codes 


Code Description 

108 DRIVE LOCKED 

109 BROKEN PIPE 

111 BUFFER OVERFLOW 

112 DISK FULL 

113 NO MORE SEARCH HANDLES 


114 
115 


INVALID TARGET HANDLE 
PROTECTION VIOLATION 


116 


VIOKBD REQUEST 


117 
118 
119 


INVALID CATEGORY 
INVALID VERIFY SWITCH 
BAD DRIVER LEVEL 


120 CALL NOT IMPLEMENTED 
121 SEM TIMEOUT 
INSUFFICIENT BUFFER 
123 INVALID NAME 
123 HPFS INVALID VOLUME CHAR 
124 INVALID LEVEL 


125 


NO VOLUME LABEL 


126 MOD NOT FOUND 
127 PROC NOT FOUND 
128 WAIT NO CHILDREN 


129 


CHILD NOT COMPLETE 


130 DIRECT ACCESS HANDLE 
131 NEGATIVE SEEK 
132 SEEK ON DEVICE 
134 IS JOINED 

135 IS SUBSTED 

136 NOT JOINED 

138 JOIN TO JOIN 

139 SUBST TO SUBST 
140 JOIN TO SUBST 
142 BUSY DRIVE 

143 SAME DRIVE 

144 DIR NOT ROOT 


145 
146 


DIR NOT EMPTY 
IS SUBST PATH 
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Table 162 (Page 5 of 19). OS/2 System Error Codes 


Code Description 
147 IS JOIN PATH 
148 PATH BUSY 


149 


IS SUBST TARGET 


150 SYSTEM TRACE 
151 INVALID EVENT COUNT 
152 TOO MANY MUXWAITERS 


153 


INVALID LIST FORMAT 


154 LABEL TOO LONG 

154 HPFS VOL LABEL LONG 
155 TOO MANY TCBS 

157 DISCARDED 

158 NOT LOCKED 

159 BAD THREADID ADDR 


160 
161 


BAD ARGUMENTS 
BAD PATHNAME 


162 


SIGNAL PENDING 


163 
164 


UNCERTAIN MEDIA 
MAX THRDS REACHED 


165 MONITORS NOT SUPPORTED 
166 UNC DRIVER NOT INSTALLED 
167 LOCK FAILED 


168 


SWAPIO FAILED 


169 SWAPIN FAILED 
170 BUSY 
171 INT TOO LONG 


173 


CANCEL VIOLATION 


174 ATOMIC LOCK NOT SUPPORTED 
175 READ LOCKS NOT SUPPORTED 
180 INVALID SEGMENT NUMBER 


181 


INVALID CALLGATE 


182 INVALID ORDINAL 
183 ALREADY EXISTS 
184 NO CHILD PROCESS 


185 


CHILD ALIVE NOWAIT 


186 INVALID FLAG NUMBER 
187 SEM NOT FOUND 
188 INVALID STARTING CODESEG 


189 
190 


INVALID STACKSEG 
INVALID MODULETYPE 
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Table 162 (Page 6 of 19). OS/2 System Error Codes 


Code Description 

191 INVALID EXE SIGNATURE 

192 EXE MARKED INVALID 

194 ITERATED DATA EXCEEDS 64K 

195 INVALID MINALLOCSIZE 

196 DYNLINK FROM INVALID RING 

198 INVALID SEGDPL 

199 AUTODATASEG EXCEEDS 64K 

200 RING2SEG MUST BE MOVABLE 
RELOC CHAIN XEEDS SEGLIM 

202 INFLOOP IN RELOG CHAIN 

203 ENVVAR NOT FOUND 

204 NOT CURRENT CTRY 

205 NO SIGNAL SENT 

206 FILENAME EXCED RANGE 

207 RING2 STACK IN USE 

208 META EXPANSION TOO LONG 

209 INVALID SIGNAL NUMBER 

210 THREAD 1 INACTIVE 

211 INFO NOT AVAIL 

212 LOCKED 

214 TOO MANY MODULES 

215 NESTING NOT ALLOWED 

216 CANNOT SHRINK 

218 STACK IN HIGH MEMORY 

219 INVALID EXITROUTINE RING 

220 GETBUF FAILED 

222 TRANSFER TOO LONG 

223 FORCENOSWAP FAILED 

224 SMG NO TARGET WINDOW 

229 INVALID SCREEN GROUP 

230 BAD PIPE 

231 PIPE BUSY 

232 NO DATA 

233 PIPE NOT CONNECTED 
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Table 162 (Page 7 of 19). OS/2 System Error Codes 


Code Description 

234 MORE DATA 

240 VC DISCONNECTED 

250 CIRCULARITY REQUESTED 
251 DIRECTORY IN CDS 

252 INVALID FSD NAME 

253 INVALID PATH 


ne) 
a 


4 


INVALID EA NAME 


255 EA LIST INCONSISTENT 

256 EA LIST TOO LONG 

257 NO META MATCH 

258 FINDNOTIFY TIMEOUT 

259 NO MORE ITEMS 

260 SEARCH STRUC REUSED 
261 CHAR NOT FOUND 

262 TOO MUCH STACK 

263 INVALID ATTR 

264 INVALID STARTING RING 
265 INVALID DLL INIT RING 

266 CANNOT COPY 

267 DIRECTORY 

268 OPLOCKED FILE 

269 OPLOCK THREAD EXISTS 
270 VOLUME CHANGED 

271 FINDNOTIFY HANDLE IN USE 
272 FINDNOTIFY HANDLE CLOSED 
273 NOTIFY OBJECT REMOVED 


nm 
“NI 


4 


ALREADY SHUTDOWN 


275 EAS DIDNT FIT 

276 EA FILE CORRUPT 

277 EA TABLE FULL 

278 INVALID EA HANDLE 
279 NO CLUSTER 

280 CREATE EA FILE 

281 CANNOT OPEN EA FILE 


Po 
[oe] 


2 


EAS NOT SUPPORTED 


283 NEED EAS FOUND 
284 DUPLICATE HANDLE 
285 DUPLICATE NAME 
286 EMPTY MUXWAIT 
287 MUTEX OWNED 
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Table 162 (Page 8 of 19). OS/2 System Error Codes 


Code Description 

288 NOT OWNER 

289 PARAM TOO SMALL 

290 TOO MANY HANDLES 

291 TOO MANY OPENS 

292 WRONG TYPE 

293 UNUSED CODE 

294 THREAD NOT TERMINATED 
295 INIT ROUTINE FAILED 

296 MODULE IN USE 

297 NOT ENOUGH WATCHPOINTS 
299 ALREADY POSTED 

300 ALREADY RESET 

301 SEM BUSY 


Oo 
o 


3 INVALID PROCID 


304 INVALID PDELTA 

305 NOT DESCENDANT 

306 NOT SESSION MANAGER 

307 INVALID PCLASS 

308 INVALID SCOPE 

309 INVALID THREADID 

310 DOSSUB SHRINK 

311 DOSSUB NOMEM 

312 DOSSUB OVERLAP 

313 DOSSUB BADSIZE 

314 DOSSUB BADFLAG 
DOSSUB BADSELEGTOR 

316 MR MSG TOO LONG 

316 MGS MR MSG TOO LONG 

317 MR MID NOT FOUND 

319 MR INV MSGF FORMAT 

320 MR INV IVCOUNT 

321 MR UN PERFORM 

322 TS WAKEUP 

323 TS SEMHANDLE 

324 TS NOTIMER 

326 TS HANDLE 

327 TS DATETIME 

328 SYS INTERNAL 
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Table 162 (Page 9 of 19). OS/2 System Error Codes 


Code Description 

329 QUE CURRENT NAME 
330 QUE PROC NOT OWNED 
331 QUE PROC OWNED 

332 QUE DUPLICATE 

333 QUE ELEMENT NOT EXIST 
334 QUE NO MEMORY 

335 QUE INVALID NAME 
336 QUE INVALID PRIORITY 
337 QUE INVALID HANDLE 
338 QUE LINK NOT FOUND 


(oe) 
(oe) 
o 


QUE MEMORY ERROR 


340 QUE PREV AT END 
341 QUE PROC NO ACCESS 
342 QUE EMPTY 


o 
- 


3 


QUE NAME NOT EXIST 


344 QUE NOT INITIALIZED 
345 QUE UNABLE TO ACCESS 
346 QUE UNABLE TO ADD 
347 QUE UNABLE TO INIT 
349 VIO INVALID MASK 
350 VIO PTR 

351 VIO APTR 

352 VIO RPTR 

353 VIO CPTR 

354 VIO LPTR 

355 VIO MODE 

357 VIO ATTR 

358 VIO ROW 

359 VIO COL 

360 VIO TOPROW 

361 VIO BOTROW 

362 VIO RIGHTCOL 

363 VIO LEFTCOL 

364 SCS CALL 

365 SCS VALUE 

366 VIO WAIT FLAG 

367 VIO UNLOCK 

368 SGS NOT SESSION MGR 
369 SMG INVALID SGID 
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Table 162 (Page 10 of 19). OS/2 System Error Codes 


Code Description 

369 SMG INVALID SESSION ID 
370 SMG NOSG 

370 SMG NO SESSIONS 

371 SMG GRP NOT FOUND 
371 SMG SESSION NOT FOUND 
372 SMG SET TITLE 

373 KBD PARAMETER 

374 KBD NO DEVICE 

375 KBD INVALID IOWAIT 

376 KBD INVALID LENGTH 


377 


KBD INVALID ECHO MASK 


377 KBD INVALID INPUT MASK 
378 KBD INVALID INPUT MASK 
379 MON INVALID PARMS 


380 


MON INVALID DEVNAME 


381 MON INVALID HANDLE 
382 MON BUFFER TOO SMALL 
383 MON BUFFER EMPTY 
384 MON DATA TOO LARGE 
385 MOUSE NO DEVICE 

386 MOUSE INV HANDLE 
387 MOUSE INV PARMS 

388 MOUSE CAN NOT RESET 
389 MOUSE DISPLAY PARMS 
390 MOUSE INV MODULE 
391 MOUSE INV ENTRY PT 


(oe) 
o 
Ne) 


MOUSE INV MASK 


393 NO MOUSE NO DATA 
394 NO MOUSE PTR DRAWN 
395 INVALID FREQUENCY 
396 NLS NO COUNTRY FILE 
396 NO COUNTRY SYS 

397 NLS OPEN FAILED 

397 OPEN COUNTRY SYS 
398 NLS NO CTRY CODE 
398 NO COUNTRY OR CODEPAGE 
399 NLS TABLE TRUNCATED 
400 NLS BAD TYPE 

401 NLS TYPE NOT FOUND 
401 COUNTRY NO TYPE 
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Table 162 (Page 11 of 19). OS/2 System Error Codes 


Code Description 

402 VIO SMG ONLY 

403 VIO INVALID ASCIIZ 
404 VIO DEREGISTER 
405 VIO NO POPUP 

406 VIO EXISTING POPUP 
407 KBD SMG ONLY 


408 


KBD INVALID ASCIIZ 


409 KBD INVALID MASK 
410 KBD REGISTER 
411 KBD DEREGISTER 


412 


MOUSE SMG ONLY 


413 MOUSE INVALID ASCIIZ 
414 MOUSE INVALID MASK 
415 MOUSE REGISTER 


416 


MOUSE DEREGISTER 


417 SMG BAD ACTION 

418 SMG INVALID CALL 

419 SCS SG NOTFOUND 

420 SCS NOT SHELL 

421 VIO INVALID PARMS 
422 VIO FUNCTION OWNED 
423 VIO RETURN 

424 SCS INVALID FUNCTION 
425 SCS NOT SESSION MGR 
426 VIO REGISTER 

427 VIO NO MODE THREAD 


428 


VIO NO SAVE RESTORE THD 


429 VIO IN BG 

430 VIO ILLEGAL DURING POPUP 
431 SMG NOT BASESHELL 

432 SMG BAD STATUSREQ 

433 QUE INVALID WAIT 

434 VIO LOCK 

435 MOUSE INVALID IOWAIT 


436 


VIO INVALID HANDLE 


437 VIO ILLEGAL DURING LOCK 
438 VIO INVALID LENGTH 

439 KBD INVALID HANDLE 

440 KBD NO MORE HANDLE 

441 KBD CANNOT CREATE KCB 
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Table 162 (Page 12 of 19). OS/2 System Error Codes 


Code Description 

442 KBD CODEPAGE LOAD INCOMPL 
443 KBD INVALID CODEPAGE ID 
444 KBD NO CODEPAGE SUPPORT 
445 KBD FOCUS REQUIRED 

446 KBD FOCUS ALREADY ACTIVE 
447 KBD KEYBOARD BUSY 

448 KBD INVALID CODEPAGE 

449 KBD UNABLE TO FOCUS 

450 SMG SESSION NON SELECT 
451 SMG SESSION NOT FOREGRND 


4 


oa 
ine) 


SMG SESSION NOT PARENT 


453 SMG INVALID START MODE 
454 SMG INVALID RELATED OPT 
455 SMG INVALID BOND OPTION 


oa 
(o>) 


4 


SMG INVALID SELECT OPT 


457 SMG START IN BACKGROUND 
458 SMG INVALID STOP OPTION 
459 SMG BAD RESERVE 

460 SMG PROCESS NOT PARENT 
461 SMG INVALID DATA LENGTH 
462 SMG NOT BOUND 

463 SMG RETRY SUB ALLOC 

464 KBD DETACHED 

465 VIO DETACHED 

466 MOU DETACHED 

467 VIO FONT 

469 VIO BAD CP 

470 VIO NO CP 

471 VIO NA CP 

472 INVALID CODE PAGE 

473 CPLIST TOO SMALL 

474 CP NOT MOVED 

475 MODE SWITCH INIT 

476 CODE PAGE NOT FOUND 

477 UNEXPECTED SLOT RETURNED 
478 SMG INVALID TRACE OPTION 
479 VIO INTERNAL RESOURCE 
480 VIO SHELL INIT 

481 SMG NO HARD ERRORS 
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Table 162 (Page 13 of 19). OS/2 System Error Codes 


Code Description 

482 CP SWITCH INCOMPLETE 

483 VIO TRANSPARENT POPUP 

484 CRITSEC OVERFLOW 

485 CRITSEC UNDERFLOW 

486 VIO BAD RESERVE 

487 INVALID ADDRESS 

488 ZERO SELECTORS REQUESTED 
489 NOT ENOUGH SELECTORS AVA 
490 INVALID SELECTOR 

491 SMG INVALID PROGRAM TYPE 


492 


SMG INVALID PGM CONTROL 


493 SMG INVALID INHERIT OPT 
494 VIO EXTENDED SG 
495 VIO NOT PRES MGR SG 


496 


VIO SHIELD OWNED 


497 VIO NO MORE HANDLES 

498 VIO SEE LOG 

499 VIO ASSOCIATED DC 

500 KBD NO CONSOLE 

501 MOUSE NO CONSOLE 

502 MOUSE INVALID HANDLE 
503 SMG INVALID DEBUG PARMS 
504 KBD EXTENDED SG 

505 MOU EXTENDED SG 

506 SMG INVALID ICON FILE 


a} o 
o;}o 
[oole ia| 


oa 
io) 
o 


TRC PID NON EXISTENT 
TRC COUNT ACTIVE 
TRC SUSPENDED BY COUNT 


510 


TRC COUNT INACTIVE 


oa 
ae 
=a 


TRC COUNT REACHED 


513 MC TRACE 
514 TRC COUNT ZERO 
515 SMG TOO MANY DDS 


516 


SMG INVALID NOTIFICATION 


517 LF INVALID FUNCTION 
518 LF NOT AVAIL 

519 LF SUSPENDED 

520 LF BUF TOO SMALL 

521 LF BUFFER CORRUPTED 
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Table 162 (Page 14 of 19). OS/2 System Error Codes 


Code Description 

521 LF BUFFER FULL 

522 LF INVALID DAEMON 
522 LF INVALID RECORD 
523 LF INVALID TEMPL 
523 LF INVALID SERVICE 
524 LF GENERAL FAILURE 


oa 
ye) 
oa 


LF INVALID ID 


526 LF INVALID HANDLE 

527 LF NO ID AVAIL 

528 LF TEMPLATE AREA FULL 
529 LF ID IN USE 

530 MOU NOT INITIALIZED 

531 MOUINITREAL DONE 

532 DOSSUB CORRUPTED 

533 MOUSE CALLER NOT SUBSYS 
534 ARITHMETIC OVERFLOW 
535 TMR NO DEVICE 

536 TMR INVALID TIME 

537 PVW INVALID ENTITY 

538 PVW INVALID ENTITY TYPE 
539 PVW INVALID SPEC 

540 PVW INVALID RANGE TYPE 
541 PVW INVALID COUNTER BLK 
542 PVW INVALID TEXT BLK 

543 PRF NOT INITIALIZED 

544 PRF ALREADY INITIALIZED 


a 
oa 


4 


PRF NOT STARTED 


546 PRF ALREADY STARTED 

547 PRF TIMER OUT OF RANGE 

548 PRF TIMER RESET 

549 HPFS CHKDSK NO PARM SPACE 
550 HPFS CHKDSK NORECOGNIZE 
551 HPFS CHKDSK NOROOT FIND 
552 HPFS CHKDSK NOFIX FS ERROR 


oa 
oa 
o 


HPFS CHKDSK CORRECT FS ERR 


554 HPFS CHKDSK ORGAN FIX 

555 HPFS CHKDSK RELOC BBPDATA 
556 HPFS CHKDSK REM CORRU BLOC 
557 HPFS CHKDSK REM CORRUP FIL 
558 HPFS CHKDSK FIX SPACE ALLO 


N 
o 
So 
e) 
Q 
iN) 
is) 
ro 
og 
= 
a 
rr) 
5 
a 


Table 162 (Page 15 of 19). OS/2 System Error Codes 


Code Description 

559 HPFS NOT FORMATTED DISK 

560 HPFS CHKDSK COR ALLOC 

561 HPFS CHKDSK SEARC UNALLOC 
562 HPFS CHKDSK DET LOST DATA 
563 HPFS CHKDSK PERCENT SEARC 
564 HPFS CHKDSK LOST DATASEARC 
565 HPFS CHKDSK CRIT NOREAD 

566 HPFS CHKDSK DISK INUSE 

567 HPFS CHKDSK RECOVTEMP RELOC 
568 HPFS TOTAL DISK SPACE 


oa 
(op) 
o 


HPFS DIR KBYTES 


570 HPFS FILE KBYTES 

571 HPFS KBYTES AVAILABLE 

572 HPFS CHKDSK PLACE REC FILE 
HPFS CHKDSK RECO DIR AS 

574 HPFS CHKDSK PLACEED DATA 

575 HPFS CHKDSK RECOV EA 

576 HPFS CHKDSK FIND EA INTEM 

577 HPFS CHKDSK RELOC TEMP EA 

578 HPFS CHKDSK RELOC AC LIST 

579 HPFS CHKDSK LIST NORELOC 

580 HPFS CHKDSK TRUN EA LIST 

581 HPFS CHKDSK TRUN EA NAME 

582 HPFS CHKDSK TRUN EA BBLOCK 

583 HPFS CHKDSK REM INVALID EA 

584 HPFS CHKDSK FIX EA ALLOC 


oa 
[oe] 
oa 


HPFS CHKDSK FIX ALACCCTRL 


586 HPFS CHKDSK ACCTR LIST BBL 
587 HPFS CHKDSK REM ACLIST 

588 HPFS CHKDSK FOUND DATANORL 
589 HPFS WRONG VERSION 

590 HPFS CHKDSK FOUND DATATEMP 
591 HPFS CHKDSK FIX TEMPSTATUS 
592 HPFS CHKDSK FIX NEEDEADATA 
593 HPFS RECOVER PARM ERROR 
594 HPFS RECOV FILE NOT FOUND 
595 HPFS RECOV UNKNOWN ERROR 
596 HPFS RECOV NOT ENOUGH MEM 
597 HPFS RECOV NOWRITE DATA 

598 HPFS RECOV NOTEMP CREATE 
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Table 162 (Page 16 of 19). OS/2 System Error Codes 


Code Description 
599 HPFS RECOV EA NOREAD 
600 HPFS RECOV FILE BYTES 


601 


HPFS RECOV BAD BYTES RECOV 


602 HPFS RECOV FILEBYTES NOREC 
603 HPFS RECOV DISK INUSE 
604 HPFS RECOV FILE NODELETE 


(op) 
oO 
oa 


HPFS RECOV NOCREATE NEWFILE 


606 HPFS RECOV SYSTEM ERROR 
607 HPFS SYS PARM ERROR 
608 HPFS SYS CANNOT INSTALL 


HPFS SYS DRIVE NOTFORMATED 


610 HPFS SYS FILE NOCREATE 
611 HPFS SIZE EXCEED 
612 HPFS SYNTAX ERR 


613 


HPFS NOTENOUGH MEM 


614 HPFS WANT MEM 
615 HPFS GET RETURNED 
616 HPFS SET RETURNED 


617 


HPFS BOTH RETURNED 


618 HPFS STOP RETURNED 
619 HPFS SETPRTYRETURNED 
620 HPFS ALCSG RETURNED 


621 


HPFS MSEC SET 


622 HPFS OPTIONS 
623 HPFS POS NUM VALUE 
624 HPFS VALUE TOO LARGE 


(o>) 
ye) 
oa 


HPFS LAZY NOT VALID 


626 HPFS VOLUME ERROR 

627 HPFS VOLUME DIRTY 

628 HPFS NEW SECTOR 

629 HPFS FORMAT PARM ERROR 
630 HPFS CANNOT ACCESS CONFIG 
631 HPFS RECOV FILE 

632 HPFS CHKDSK KBYTES RESERVE 


[op) 
(oe) 
wo 


HPFS CHKDSK KBYTES IN EA 


634 HPFS BYTEBUF SET 

635 HPFS FORMATTING COMPLETE 
636 HPFS WRONG VOLUME LABEL 
637 HPFS FMAT TOO MANY DRS 
638 VDD UNSUPPORTED ACCESS 


N 
o 
iw) 
e) 
Q 
iN) 
is) 
ro 
og 
= 
a 
rr) 
5 
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Table 162 (Page 17 of 19). OS/2 System Error Codes 


Code Description 

639 VDD LOCK USEAGE DENIED 
640 TIMEOUT 

641 VDM DOWN 

642 VDM LIMIT 

643 VDD NOT FOUND 

644 INVALID CALLER 


(o>) 
aS 
oa 


PID MISMATCH 


646 INVALID VDD HANDLE 

647 VLPT NO SPOOLER 

648 VCOM DEVICE BUSY 

649 VLPT DEVICE BUSY 

650 NESTING TOO DEEP 

651 VDD MISSING 

671 BIDI INVALID LENGTH 

672 BIDI INVALID INCREMENT 
673 BIDI INVALID COMBINATION 
674 BIDI INVALID RESERVED 
675 BIDI INVALID EFFECT 

676 BIDI INVALID CSDREC 

677 BIDI INVALID CSDSTATE 
678 BIDI INVALID LEVEL 

679 BIDI INVALID TYPE SUPPORT 
680 BIDI INVALID ORIENTATION 
681 BIDI INVALID NUM SHAPE 
682 BIDI INVALID CSD 

683 BIDI NO SUPPORT 

684 NO BIDI RW INCOMPLETE 
689 HPFS LAZY ON 

690 HPFS LAZY OFF 

691 IMP INVALID PARM 

692 IMP INVALID LENGTH 

693 MSG HPFS DISK WARN 
694 MSG HPFS FNODE WARN 
730 MON BAD BUFFER 


731 


MODULE CORRUPTED 


732 BOOT DRIVE NOT ACCESSIBLE 
1477 SM OUTOF SWAPFILE 
2055 LF TIMEOUT 


2057 
2058 


LF SUSPEND SUCCESS 
LF RESUME SUCCESS 
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Table 162 (Page 18 of 19). OS/2 System Error Codes 


Code Description 
2059 LF REDIRECT SUCCESS 
2060 LF REDIRECT FAILURE 


32768 


SWAPPER NOT ACTIVE 
INVALID SWAPID 


IOERR SWAP FILE 


32772 


SWAP TABLE FULL 
SWAP FILE FULL 
CANT INIT SWAPPER 


SWAPPER ALREADY INIT 


32776 


PMM INSUFFICIENT MEMORY 
PMM INVALID FLAGS 
PMM INVALID ADDRESS 


PMM LOCK FAILED 


32780 


PMM UNLOCK FAILED 
PMM MOVE INCOMPLETE 
UCOM DRIVE RENAMED 


UCOM FILENAME TRUNCATED 


32784 


UCOM BUFFER LENGTH 
MON CHAIN HANDLE 
MON NOT REGISTERED 


SMG ALREADY TOP 


32788 


PMM ARENA MODIFIED 
SMG PRINTER OPEN 
PMM SET FLAGS FAILED 


INVALID DOS DD 


BLOCKED 
INSTANCE SHARED 
NO OBJECT 
PARTIAL ATTACH 


SWAP IO PROBLEMS 


CROSSES OBJECT BOUNDARY 


LONGLOCK 

UVIRTLOCK 
ALIASLOCK 
ALIAS 


32804 


32805 


NO MORE HANDLES 
SCAN TERMINATED 
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Table 162 (Page 19 of 19). OS/2 System Error Codes 


Description 


TERMINATOR NOT FOUND 


NOT DIRECT CHILD 


GUARDPAGE 
SWAPERROR 
LDRERROR 
NOACCESS 
NO DLL TERM 


65027 


CPSIO CODE PAGE INVALID 
CPSIO NO SPOOLER 
CPSIO FONT ID INVALID 


CPSIO INTERNAL ERROR 


65037 


CPSIO INVALID PTR NAME 
CPSIO NOT ACTIVE 
CPSIO PID FULL 


CPSIO PID NOT FOUND 


65045 


CPSIO READ CTL SEQ 
CPSIO READ FNT DEF 
CPSIO WRITE ERROR 


CPSIO WRITE FULL ERROR 


65074 


CPSIO WRITE HANDLE BAD 
CPSIO SWIT LOAD 
CPSIO INV COMMAND 


CPSIO NO FONT SWIT 


OxFFOO 


DOS INT 24 Critical Error Codes 


ENTRY IS CALLGATE 
USER DEFINED BASE 


Table 163 (Page 1 of 2). DOS INT 24 Critical Error Codes 


Code 


Description 


124 WRITE PROTECT 


124 BAD UNIT 


124 NOT READY 
124 BAD COMMAND 
124 CRC 


124 BAD LENGTH 


124 SEEK 
124 NOT DOS DISK 
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Table 163 (Page 2 of 2). DOS INT 24 Critical Error Codes 


Code Description 


124 SECTOR NOT FOUND 


124 OUT OF PAPER 
124 WRITE FAULT 
124 READ FAULT 


124 GEN FAILURE 


124 DISK CHANGE 
124 WRONG DISK 
124 UNCERTAIN MEDIA 


124 CHAR CALL INTERRUPTED 


124 NO MONITOR SUPPORT 
124 INVALID PARAMETER 
20 124 DEVICE IN USE 


a/a7/ 32/427 = /42)/] 2/4] a|] oO] o@ 
Ola NI ODI! aso; nwm|]-_]o 


ye) 
ere 


124 QUIET INIT FAIL 
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4.2 OS/2 System Exception Codes 


The exception values are 32-bit values laid out as follows: 


i ao Je ay Sy Any le atta 2g Un Ee ne Ket ine Es ee 
10987654321098765432109876543210 
ied 
|Sev|C| Facility | Code | 
[cee | 
where 


00 - Success 

01 - Informational 

10 - Warning 

11 - Error 
C - is the Customer code flag 
Facility - is the facility code 


Code - is the facility’s status code 


Exceptions specific to OS/2 2.0 (e.g. XCPT SIGNAL) will be marked 
with a facility code of l. 


Figure 36. Exception Values Layout 


80000001H 
XCPT_GUARD_PAGE_VIOLATION 


P1 Access Code 


00000001H XCPT_READ_ACCESS 
00000002H XCPT_WRITE_ACCESS 


P2 FaultAddr 


80010001H 
XCPT_UNABLE_TO_GROW_STACK 


0C0010001H 
XCPT_PROCESS_TERMINATE 


0C0010002H 
XCPT_ASYNC_PROCESS_ TERMINATE 


P1 TID of terminator thread 


0C0010003H 
XCPT_SIGNAL 
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P1 Signal Number 


1 XCPT_SIGNAL_INTR 
3 XCPT_SIGNAL_KILLPROC 
4 XCPT_SIGNAL_BREAK 


0C0010004H 
XCPT_B1NPX_ERRATA_02 


0C0000005H 
XCPT_ACCESS_VIOLATION 


This relates to Traps 0x09, Ox0b, OxOc, Ox0d and Ox0e. 


P1 Access Code 


00000000H XCPT_UNKNOWN_ACCESS 
00000001H XCPT_READ_ACCESS 
00000002H XCPT_WRITE_ACCESS 
00000004H XCPT_EXECUTE_ACCESS 
00000008H XCPT_SPACE_ACCESS 
00000010H XCPT_LIMIT_ACCESS 


P2 
FaultAddr XCPT_ READ _ACCESS/XCPT_WRITE_ACCESS 
Selector XCPT_SPACE_ACCESS 
-1 XCPT_LIMIT_ACCESS 
0C0000006H 


XCPT_IN_PAGE_ERROR 


This relates to Trap Ox0e. 

P1 FaultAddr 
0C000001CH 

XCPT_ILLEGAL_INSTRUCTION 


This relates to Trap 0x06. 


0C000001DH 
XCPT_INVALID_LOCK_SEQUENCE 


0C0000024H 
XCPT_NONCONTINUABLE_EXCEPTION 


0C0000025H 
XCPT_INVALID_DISPOSITION 


0C0000026H 
XCPT_UNWIND 
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0C0000027H 
XCPT_BAD_STACK 


0C0000028H 
XCPT_INVALID_UNWIND_TARGET 


0C0000093H 
XCPT_ARRAY_BOUNDS_EXCEEDED 


This relates to Trap 0x05. 


0C0000094H 
XCPT_FLOAT_DENORMAL_OPERAND 


This relates to Trap 0x10. 


0C0000095H 
XCPT_FLOAT_DIVIDE_BY_ZERO 


This relates to Trap 0x10. 


0C0000096H 
XCPT_FLOAT_INEXACT_RESULT 


This relates to Trap 0x10. 


0C0000097H 
XCPT_FLOAT_INVALID_OPERATION 


This relates to Trap 0x10. 


0C0000098H 
XCPT_FLOAT_OVERFLOW 


This relates to Trap 0x10. 


0C0000099H 
XCPT_FLOAT_STACK_CHECK 


This relates to Trap 0x10. 


0C000009AH 
XCPT_FLOAT_UNDERFLOW 


This relates to Trap 0x10. 


0C000009BH 
XCPT_INTEGER_DIVIDE_BY_ZERO 


This relates to Trap 0x00. 
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0C000009CH 
XCPT_INTEGER_OVERFLOW 


This relates to Trap 0x04. 


0C000009DH 
XCPT_PRIVILEGED_INSTRUCTION 


This relates to Trap Ox0Od. 


O0CO00009EH 
XCPT_DATATYPE_MISALIGNMENT 


This relates to Trap 0x11. 


P1 Access Code 


00000001H XCPT_READ_ACCESS 
00000002H XCPT_WRITE_ACCESS 


P2 Alignment 
P3 FaultAddr 
0CO00009FH 


XCPT_BREAKPOINT 
This relates to Trap 0x03. 


0CO00000A0H 
XCPT_SINGLE_STEP 


This relates to Trap 0x01. 


For further information refer to: 


* OS/2 Technical Library - Control Program Programming Reference, Appendix 
C. 


* The BSEXCPT.H or BSEXCPT.INC include files supplied with the OS/2 
Programmers Toolkit. 
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4.3 Trap Screen Reference 


The trap screen has two basic formats: 


The application trap (SYS3175 and SYS3171) messages. 


The Internal Processing Error (IPE). 


08-09-1995 17:22:41 SYS3171 PID 0054 

E: \RJM\INVERTP\ INVERTP. EXE 

c0000005 

00010267 

P1=00000008 P2=6d640000 P3=XXXXXXXX P4=XXXXXXXX 
EAX=00000000 EBX=00000000 ECX=00000000 EDX=00000000 
ES1=00000000 EDI=00000000 

DS=0053 DSACC=d0f3 DSLIM=1bffffff 

ES=0053 ESACC=d0f3 ESLIM=lbf ff fff 

FS=150b FSACC=00f3 FSLIM=00000030 

GS=0000 GSACC=**** GSLIM=******** 

CS: EIP=005b:00010267 CSACC=dOdf CSLIM=1bfffftf 
SS:ESP=0000:00201ff0 SSACC=**** SSLIM=******** 
EBP=00201ff4 FLG=00002306 


INVERTP.EXE 0001:00000267 


Figure 


37. Application Trap 


The information presented varies slightly according to circumstance. 


In general, 


inapplicable information is either omitted or overlayed with asterisks (*) or Xs. 


Each line of the trap screen conveys the following meaning: 


1. Date and Time or Trap, Trap message ID and Failing Process ID. This may 


also include the thread slot number and module handle. 


2. Failing module. 


3. Exception code. See 4.2, “OS/2 System Exception Codes” on page 237 fora 


complete set of system generated exceptions. 


4. Instruction address at time of exception. 


5. Exception Information Parameters. See 4.2, “OS/2 System Exception Codes” 
on page 237 for the exception information parameters that are associated 


with each system exception. 


6. The EAX, EXB, EXC and EDX registers at the time the exception was 


reported. 


7. The ESI and EDI registers at the time the exception was reported. 
8. The DS selector at the time the exception was reported. 


This information is presented in the form: 


xS=nnnn The selector value. 
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xSACCz=nnnn The descriptor access bits. 


Reading from right to left the bits of the access field are assigned 


the following meaning: 
0 (A) 1=Accessed 


1 (W) 1=Writeable 

2 (E) 1=Executable 

3 0 

4 (S) 1=Application 0=System 
5&6 (DPL) Privilege Level 

7 (P) 1=Segment present 
8-11 0 

12 (AVL) 1=UVIRT allocation 

13 (D) 1=32-bit Operands/Data 
14 0 

15 (G) 1=4K granularity limit, O=byte granularity limit 


See the INTEL Pentium Users Guide, Volume 3 for more 
information on descriptor formats. 
xSLIM=nnnnnnnn The limit address from the descriptor. 


9. The ES selector at the time the exception was reported. 
10. The FS selector at the time the exception was reported. 


11. The GS selector at the time the exception was reported. 


12. The instruction address at the time the exception was reported, followed by 


the CS selector Limit and Access fields. 


13. The stack address at the time the exception was reported, followed by the 
SS selector Limit and Access fields. 


14. The EBP register and EFLAGS register. 


15. The module name and relative object and offset within the module that 
corresponds the the CS:EIP at the time of exception. 


System Internal Processing Error (IPE) 


The IPE message appears because of a fatal internal error condition. This may 


or may not be a trap, although the IPE trap is the most common. 


The IPE message has the general format: 


1-> <IPE specific Message> 


2-> THE SYSTEM DETECTED AN INTERNAL PROCESSING 
ERROR AT LOCATION ##xxxx:yyyyyyyy - aaaa:bbbb 


3-> eeeee , 1111 
4-> 038600d1 
5-> INTERNAL REVISION 6 . 307 DATE: 92/03/01 


The parts of the IPE message are: 


1. IPE specific message, which could be a simple line of text, for example: 


TRAP 0002 ERRCD 


CPS: Empty allocation block--not supported. 


or a formatted register dump for a system trap, such as: 


= 0000 ERACC= **** ERLIM= te 


EAX= 7d240a58 EBX= ff202fdc ECX= 00064423 EDX= 00003624 
ESI= fff3272c EDI= 7d240004 EBP= 00004a44 FLG= 00003202 
CS:EIP= 0160 : fff702a6 CSACC= cO9d CSLIM= ffffffttf 
SS:ESP= 0030 : 00004a38 SSACC= 1097 SSLIM= 00003fff 


DS= 0158 DSACC= cOf3 
ES= 0158 ESACC= cOf3 
FS= 0000 FSACC= **** 
GS= 0000 GSACC= **** 


DSLIM= ffffffff CRO= fffffffb 
ESLIM- ffffffff CR2= 12060014 
FSLIM= KKEKKKKEKE 
GSLIM= KKEKKKKKK 


Figure 38. Formatted Regsister Dump for a System Trap 


2. 


os 


The CS:EIP of the caller to the kernel panic routine is shown as 
#EXXXX:yyyyyyyy. For traps this will always be an address within the trap 
handler and not the address at which the error occurred, which is given in 
the error specific message. 


The CS:EIP is prefixed with either ## to indicate protect mode, paging 
enables in accordance with the Kernel Debugger command prompt. 


The kernel relative object:offset address is shown as aaaa:bbbb. 


. eeeee is intended to be an internal error code and //ll source line number 


information. These may not contain meaningful data. 


The processor ID. 


. The kernel revision information. 


example of the IPE trap screen is show in the following diagram: 


1-> TRAP 0002 ERRCD= 0000 ERACC= **** ERLIM= *******% 
EAX= 7d240a58 EBX= ff202fdc ECX= 00064423 EDX= 00003624 
ESI= fff3272c EDI= 7d240004 EBP= 00004a44 FLG= 00003202 

2-> CS:EIP= 0160 : fff702a6 CSACC= cO9d CSLIM= fffffttf 
SS:ESP= 0030 : 00004a38 SSACC= 1097 SSLIM= 00003fff 


DS= 0158 DSACC= 
ES= 0158 ESACC= 
FS= 0000 FSACC= 
GS= 0000 GSACC= 


cOf3 DSLIM= ffffffff CRO= fffffffb 
cOf3 ESLIM= ffffffff CR2= 12060014 


KKKK FSLIM= KKKKKKKK 
KKKK GSLIM= KKEKKKKKK 


THE SYSTEM DETECTED AN INTERNAL PROCESSING 


ERROR AT LOCATION 
60000 , 9084 


038600d1 
INTERNAL REVISION 


Figure 39. IPE Trap Screen 


##0160: fff6453F - 000d: a53f 


6 . 307 DATE: 92/03/01 


The register information may be interpreted to be for application trap screens, 
with the following notes: 
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1. This line shows the trap number followed by the INTEL error code. Most 
often the associated error code is a selector number. When this is the case, 
this line formats the selector’s access and limit values. 


2. This line shows the address at which the trap occurred. 

3. The value of control register 0 (CRO) is formatter after the DS register. 
CRO contains processor control mode settings. 

4. The value of control register 2 (CR2) is formatter after the ES register. 


CR2 contains the fault address for TRAP E errors. 
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4.4 Standard GDT Assignments 


The following table lists the GDT assignments that are statically assigned or 


assigned dynamically during initialization. 


This list is subject to change from release to release but may be verified by 


listing symbols from OS2KRNL segment DOSGDTDATA using the Kernel 


Debugger LS command. 


Table 164 (Page 1 of 3). GDT Assignments 


Selector Symbol 


GDT_GDT 


Description 
entry 0 is reserved (invalid) 


entry 8 used to be GDT (now invalid) 


GDT_TSS 


Protect mode TSS 


GDT_IDT 


GDT_RM_IDT 


GDT_LDT 


Protect Mode IDT 
Selector for 1st 1K 


Selector for LDT 


GDT_PTDA 


PTDA/TCB/TSD selector 


GDT_FPEM 


GDT_ROMDATA 


GDT_R2DS 


Floating Point Emulator Work Area 
ROM data at 40h 
Ring 2 Data Selector 


GDT_R3DS 


Ring 3 Data Selector 


GDT_R3CS 


GDT_R38PDS 


GDT_R3THKDS, 


Ring 3 Code Selector 
Ring 3 Protected Data Selector 
Ring 3 Thunk Data Selector 


GDT_SAS, 


System Anchor Segment 


GDT_DOSALIAS 


GDT_SYSINFOSEG 


GDT_DFTSS 


SAS Read/Write Alias 
InfosegGDT 
Double Fault TSS 


GDT_DFSTACK 


Trap 8 stack selector 


GDT_VPB 


GDT_RDR1 


GDT_Buffers 


VPB BMP Segment 
Reserved 


Buffer Pool Segment 


GDT_Unused 


unused selector (used to be MFT) 


GDT_RLR 


GDT_FSC 


RLR selector 
SFT selector of first SFT segment 


FSC array segment selector 


GDT_mFSD 


mini-FSD 


GDT_RIPL 


GDT_NULLIDT 


GDT_INTSTACK 


Remote IPL data 
Invalid descriptor for mode switch 


Interrupt stack alias 


GDT_RMCODE 


386 modesw code selector 


GDT_RMDATA 


100 DOSHLP_CODESEL 


386 modesw data selector 


DosHIp Code Selector 
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Table 164 (Page 2 of 3). GDT Assignments 


Selector Symbol 


Description 


108 GDT_Pool 


Start of dynamic GDT allocations 


1508 GDT_Poolend 


150b GDT_TIB 


GDT_DOSALLOCSEG 


End of dynamic GDT allocations 
TIB selector 


DOSALLOCSEG call gate 


GDT_DOSALLOCPROTSEG 


DOSALLOCPROTSEG call gate 


GDT_DOSDYNAMICTRACE 


1d28 GDT_DOSERROR 


GDT_DOSFREERESOURCE 


DOSDYNAMICTRACE call gate 
DOSERROR call gate 
DOSFREERESOURCE call gate 


GDT_DOSQUERYABIOSSUPPORT 


DOSQUERYABIOSSUPPORT call gate 


GDT_DOS16LDRDIRTYWORKER 


1d48 GDT_DOSFREESEG 


GDT_DOSGETPROCADDR 


DOS16LDRDIRTYWORKER call gate 
DOSFREESEG call gate 
DOSGETPROCADDR call gate 


GDT_DOSIEXECPGM 


DOSIEXECPGM call gate 


GDT_DOSIQAPPTYPE 


1d68 GDT_DOSISEMWAIT 


GDT_DOSLOADMODULE 


DOSIQAPPTYPE call gate 
DOSISEMWAIT call gate 
DOSLOADMODULE call gate 


GDT_DOSMAKEPIPE 


DOSMAKEPIPE call gate 


GDT_DOSREALLOCSEG 


1d88 GDT_DOSSICG 


GDT_PANICWRITE 


DOSREALLOCSEG call gate 
DOSSICG call gate 
PANICWRITE call gate 


GDT_DOSSETPRTY 


DOSSETPRTY call gate 


GDT_DOSLOGMODE 


1da8 GDT_DOSSETCP 


GDT_DOSGLOBALSEG 


DOSLOGMODE call gate 
DOSSETCP call gate 
DOSGLOBALSEG call gate 


GDT_DOSCREATETHREAD 


DOSCREATETHREAD call gate 


GDT_DOSEXIT 


1dc8 GDT_DOSEXITLIST 


GDT_DOSFREEMODULE 


DOSEXIT call gate 
DOSEXITLIST call gate 
DOSFREEMODULE call gate 


GDT_DOSRESUMETHREAD 


DOSRESUMETHREAD call gate 


GDT_DOSSLEEP 


1de8 GDT_DOSSUSPENDTHREAD 


GDT_DOSLIBINIT 


DOSSLEEP call gate 
DOSSUSPENDTHREAD call gate 
DOSLIBINIT call gate 


GDT_REDIR 


REDIR call gate 


GDT_DOSCHGFILEPTR 


1e08 GDT_DOSPROTECTCHGFILEPTR 


GDT_DOSCLOSE 


DOSCHGFILEPTR call gate 
DOSPROTECTCHGFILEPTR call gate 
DOSCLOSE call gate 


GDT_DOSPROTECTCLOSE 


DOSPROTECTCLOSE call gate 


GDT_DOSDELETE 


1e28 GDT_DOSDEVIOCTL 


1e30 GDT_DOSDEVIOCTL2 


DOSDELETE call gate 
DOSDEVIOCTL call gate 
DOSDEVIOCTL2 call gate 
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Table 164 (Page 3 of 3). GDT Assignments 


Selector 


Symbol 


Description 


1e38 


GDT_DOSDUPHANDLE 


DOSDUPHANDLE call gate 


1e40 


1648 GDT_DOSIREAD 


GDT_DOSICOPY 


GDT_DOSIPROTECTREAD 


DOSICOPY call gate 
DOSIREAD call gate 
DOSIPROTECTREAD call gate 


GDT_DOSISETRELMAXFH 


DOSISETRELMAXFH call gate 


1e68 GDT_DOSIPROTECTWRITE 


GDT_DOSIWRITE 


GDT_DOSMOVE 


DOSIWRITE call gate 
DOSIPROTECTWRITE call gate 
DOSMOVE call gate 


GDT_DOSOPEN 


DOSOPEN call gate 


GDT_MSSTACK 


1e90 GDT_OS2LDR os2ldr’s data 


GDT_NWDTSS 


NMI TSS 


GDT_NWDSTACK 


NMI Stack Selector 


GDT_ROCSC 


RO Code Selector for Init DDs 
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4.5 Standard LDT Assignments 


The following table lists the LDT assignments that are defined by the system. 


Table 165. Standard LDT Assignments 


Selector Description 
Read/Only access to the current LDT 


Read/Only access to the current Global Information Segment 


Read/Only access to the current Local Information Segment 
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4.6 VM System Object Owner IDs 


System objects are a reserved range of hobs used to attribute ownership of 


virtual memory objects to system components. System object IDs have no 


corresponding VMOB. 


The following table lists the system object IDs. The names shown are those 


displayed by the Kernel Debugger and Dump Formatter when formatting VMOB 


structures: 


Table 166 (Page 1 of 6). System Object IDs 


Name ID 


Description 


lielist Oxff2d 


LDR LieLists 


demversion Oxff2e 


npipenpn Oxff30 


DEM fake version entries 
VM Arena Bitmap Directory 
Named pipe NPN segment 


npipenp Oxff31 


Named pipe NP segment 


reqpkttcb Oxff32 


reqpkt2 Oxff33 


spldevrmp Oxff34 


DD TCB request packets 
DD strat2 request packets 
Spool Dev RMP segment 


chardevrmp Oxff35 


Char Dev RMP segment 


syssemrmp Oxff36 


System Semaphore RMP segment 


libpath Oxff38 LDR LibPath 
jfnflags Oxff39 JFN flags 
jfntable Oxff8a JFN table 


tkr3stack Oxff3c 


PhysToUVirt 
Ring 3 stack 


tkr2stack Oxff3d 


Ring 2 stack 


tkenv Oxff8e 


reqpkt1 Oxff40 


User Environment 
Thread Information Block 


DD strat1 request packets 


allocphys Oxff41 


Allocated via DevHlp AllocPhys 


khbdon Oxff42 


krhroim Oxff44 


Unusable donated heap page owner 
Resident R/W 1Meg mem heap owner 


Resident R/W 1Meg mem heap owner 


mmph Oxff45 


dekko mapped memory 


pageio Oxff46 


1) File System ‘Drivers 


pageio per-swap-file save block 


record lock record owner 


Oxff48 FSD 1 
Oxff49 FSD 2 
fsd4 Oxff4b FSD 4 
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Table 166 (Page 2 of 6). System Object IDs 


Name ID Description 
fsd5 Oxff4c FSD 5 
fsd6 Oxff4d FSD 6 


Oxff4f 


FSD 8 and subsequent 


oe Device Drivers: 


Oxff50 


device driver 1 
dd2 device driver 2 
dd3 Oxff52 device driver 3 
dd4 Oxff53 device driver 4 
dd5 Oxff54 device driver 5 
dd7 Oxff56 device driver 7 
dd8 Oxff57 device driver 8 
ddg Oxff58 device driver 9 
dd11 Oxff5a device driver 11 
ddi2 Oxff5b device driver 12 
dd13 Oxff5c device driver 13 
Oxff5e device driver 15 
Oxff5f device driver 16 and subsequent 


Oxff61 


_Miscellaneous Owners _ 


cluster map owner 


Current Directory Structure RMP seg 


Oxff62 


Timeout Manager 


Oxff63 


dbgdcb Oxff65 


Advanced BIOS 
cache 


DBG Debug Control Block 


dbgkdb Oxff66 


DBG Kernel Debug Block 


dbgwpcb Oxff67 


DBP Watch Point Control Block 
DEM SFT array (for FCBs) 
DEM font offsets 


DEM font data 


demfonto Oxff69 
demfont Oxff6a 
devhip Oxff6b 


Oxff6d 


allocated via devhlp AllocPhys 
discardable, zero fill object 


DosHelp segment 


Oxff6e 


DYN trace point parm block 


Oxff6f 


dynmtel Oxff71 


dynamic trace point 
tmp dynamic trace info 


DYN MTE dynamic trace link 
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Table 166 (Page 3 of 6). System Object IDs 


Name ID Description 
emalloc Oxff72 EM86 malloc() 
emtss Oxff73 EM86 TSS 


infoseg Oxff75 


installed device driver 


infoseg (local or global) 


initmsg Oxff76 


INIT saved message 


init Oxff77 


intstack Oxff79 


generic init-time only 
INT IRQ info 


interrupt stack 


iopllist Oxff7a 


List of modules with IOPL 


kdbalias Oxff7b 


kdbsym Oxff7c 


kmhook Oxff7d 


Kernel debugger alias 
Kernel debugger symbol 


KM hook info 


ksem Oxff7e 


KSEM semaphore 


lbdd Oxff7f 


monitor Oxff81 


loadable base device driver 
ABIOS logical identifier 


monitor segment 


mshare Oxff82 


named-shared 


mshrmp Oxff83 


npx Oxff85 


RMP having mshare records 
non maskable interrupt 


287/387 save area 


orphan Oxff86 


orphaned segment 


prof Oxff87 


ptovirt Oxff89 


profile support 
Allocated via dh_allocateGDTSelector 


PhysToVirt 


puse Oxff8a 


Page Usage 


pusetmp Oxff8b 


qscache Oxff8d 


tmp Page Usage 
Perfview 


QuerySysInfo cache 


ras Oxff8e 


RAS segment 


resource Oxff8f 


Oxff91 


Resource BMP segment 
system service 


timer services segment 


Oxff92 


TRAP Hard Error 


cdevitmp Oxff94 


File System Owners 


file system buffer 


Char DEV TMP 


fsc Oxff95 


FSC segment 


dpb Oxff96 


fatsrch Oxff98 


DPB 
fat EA TMP 


fat search segment 
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Table 166 (Page 4 of 6). System Object IDs 


Name ID 


Description 


gnotify Oxff99 


FindNotify global segment 


pnotify Oxff9a 


FindNotify private segment 
installable file sys helper 


installable file system 


mini file system 


ifs Oxff9c 
mfsd Oxff9d 
mft Oxff9e 


pipe Oxffa0 


master file table 
Named pipe I/O buffer segment 
pipe 


sft Oxffat 


system file table 


Oxffa2 


Idcache Oxffa3 


volume parameter block 


= Loader Owners 


Loader Instance Data Cache 


Idrdid Oxffa4 


LDR Dynamic Load record 


invalid Oxffa5 


Idrpath Oxffa7 


Cache being made 
mte 


LDR MTE path 


Idrnres Oxffa8 


LDR non-resident names 


proti6 Oxffa9 


os2krnl Oxffaa 


Protect 16 list 


Boot Loader and Kernel Owners — 


os2krni load image 


os2lidr Oxffab 


os2ldr load image 


ripl Oxffac 


pgalias Oxffad 


Remote IPL (remote boot) 


: Page ‘Manager Owners : 


Temporary page manager aliases 


pgbuf Oxffae 


PG loader and swapper buffer 


pgcrpte Oxffaf 


pgdir Oxffb1 


PG Compat. region page table 
debugger alias pte 


PG Page directory 


pgkstack Oxffb2 


kernel stack region 


Pgvp Oxffb3 


pgprt Oxffb5 


VP array 
PF array 
Page Range Table 


pgsyspte Oxffb6 


PG System page tables 


selheap Oxffb8 


_Selector Manager Qwners. 


SEL GDT 


Selector-mapped heap block 


Idt Oxffb9 


SEL LDT 


lock Oxffba 


seluvirt Oxffbc 


SEL Lock 
NO-OP Locks 
SEL UVIRT mapping 
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Table 166 (Page 5 of 6). System Object IDs 


Description 


|. Semaphore Owners 


semmisc 


semopenqg Oxffbf 


SEM Miscellaneous 
SEM Mux Queue 
SEM Open Queue 


semrec OxffcO 


SEM SemRecord 


semstr Oxffce1 


semtable Oxffc3 


SEM string 
SEM Main structure 
SEM Private/Shared table 


| Swapper Owners. 


smdfh Oxffc4 


smsf Oxffc6 


SM Disk Frame Heap 
SM SFN array 
SM Swap Frame 


qe Tasking -Qwners : 


tkextlst Oxffc7 


tkkmreg Oxffc8 


tklibif Oxffc9 


TK Exit List record 
TK dispatch (KM) registers 


TK LibInit Free Notification record 


tklibi Oxffca 


TK LibInit record 


ptda Oxffcb 


tsd Oxffcd 


TK PTDA 
TK TCB 
TK TSD 


a i VDD, MDH, V.DM Owners 


vddblkh Oxffce 


vddblk Oxffcf 


vddcfstr OxffdO 


VDD block header 
VDD memory block 
VDD config.sys string 


vddctmp Oxffd1 


VDD creation tmp allocation 


vddep Oxffd2 


vddheaph Oxffd3 


vddheap Oxffd4 


VDD Entry Point 
VDD heap header 
heap objects to load VDDs 


vddhook Oxffd5 


VDD hook 


vddla Oxffd6 


vddmod Oxffd8 


VDD Linear Arena header 
VDD Linear arena Record 


VDD module record 


vddopen Oxtfd9 


open VDD record 


vddpddep Oxffda 


vddstr Oxffdce 


VDD PDD Entry Point 
VDD procedure record 


VDD string 


vdhfhook Oxffdd 


VDH fault hook 


vdhalloc Oxffde 


vdmalias Oxffed 


VDH services resident memory 
VDH services swappable memory 


VDM Alias 
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Table 166 (Page 6 of 6). System Object IDs 


Description 


|. Virtual Memory Manager Owners. 


VM arena header 


Oxffe3 VM Arena Record 
Oxffe4 VM Location Bitmap 
Oxffe5 VM Context Record 
vmhsh Oxffe7 VM Location Hash Table 
vmkrhb Oxffe8 VM *UNKNOWN* busy KRHB 
vmkrhf Oxffe9 VM free KRHB 
vmkrhro Oxffeb VM Public Kernel Resident R/O Heap 
vmkrhrw Oxffec VM Public Kernel Resident R/W Heap 
vmkshd Oxffed VM Swappable Heap Descriptor 
VM Public Kernel Swappable R/O Heap 
vmkshrw Oxffef VM Public Kernel Swappable R/W Heap 
vmllock OxfffO VM long term lock manager 
vmob Oxfff1 VM Object Record 
VM Screen Group Switch record 
vmbmp16 Oxfff3 VM Temp buf (BMP16) 
shrind Oxfff4 reserved for shared indicator 
give Oxfff5 giveable segment 
giveget Oxfff7 giveable and gettable segment 
preload Oxfff8 Loader’s preload object 


254 os/2 Debugging 


4.7 DevHip Function Cross-Reference 


The following table is a cross-reference for DevHlp function names with request 
code. The request code is loaded into the DL register before calling 


Device_Help. 


Table 167 (Page 1 of 3). DevHlp Function Cross-Reference 


Function Name Code 


Description 


DevHIip_SchedClock 0x0 


Called each timer tick 


DevHIp_DevDone 0x1 


DevHIp_Yield 0x2 


Device I/O complete 
Device I/O complete 


yield CPU if resched set 


DevHIp_TCYield 0x3 


yield to time critical task 


DevHIp_ProcBlock 0x4 


DevHlp_SemRequest Ox6 


Block on event 
Unblock process 


claim a semaphore 


DevHlp_SemClear 0x7 


release a semaphore 


DevHlp_SemHandle 0x8 


DevHIp_PushRequest 0x9 


DevHIp_PullRequest OxA 


obtain a semaphore handle 
Push the request 


Pull next request from Q 


DevHlp_PullParticular 0xB 


Pull a specific request 


DevHlp_SortRequest 0xC 


DevHIp_AllocReqPacket 0xD 


DevHlIp_FreeReqPacket OxE 


Push request in sorted order 
allocate request packet 


free request packet 


DevHIp_Queuelnit OxF 


Init/Clear char queue 


DevHlp_QueueFlush 0x10 


DevHIip_QueueWrite 0x11 


DevHlp_QueueRead 0x12 


flush queue 
Put a char in the queue 


Get a char from the queue 


DevHIp_Lock 0x13 


Lock segment 


DevHIp_Unlock 0x14 


DevHIp_PhysTovVirt 0x15 


DevHlp_VirtToPhys 0x16 


Unlock segment 
convert physical address to virtual 


convert virtual address to physical 


DevHIp_PhysToUVirt 0x17 


convert physical to LDT 


DevHIp_AllocPhys 0x18 


DevHIp_FreePhys 0x19 


DevHIlp_SetROMVector Ox1A 


allocate physical memory 
free physical memory 


set a ROM service routine vector 


DevHIp_SetIRQ 0x1B 


set an IRQ interrupt 


DevHIp_UnSetIRQ 0x1C 


DevHlip_ResetTimer Ox1E 


unset an IRQ interrupt 
set timer request handler 


unset timer request handler 


DevHIp_MonitorCreate Ox1F 


create a monitor 


DevHIp_Register 0x20 


install a monitor 


remove a monitor 
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Table 167 (Page 2 of 3). DevHlp Function Cross-Reference 


Function Name Code 


Description 


DevHIp_MonWrite 0x22 


pass data records to monitor 


DevHIp_MonFlush 0x23 


DevHlp_SendEvent 0x25 


remove all data from stream 
Return pointer to DOS variable 


an event occurred 


DevHlp_ROMCritSection 0x26 


ROM Critical Section 


DevHIp_VerifyAccess 0x27 


DevHlIp_RAS 0x28 


DevHlp_ABIOSGetParms 0x29 


Verify access to memory 
Put info in RAS trace buffer 
Get ABIOS Calling Parms 


DevHIp_AttachDD Ox2A 


Attach to a device driver 


DevHIp_InternalError 0x2B 


DevHIp_ModifyPriority 0x2C 


DevHIp_AllocGDTSelector 0x2D 


Signal an internal error 
Undocumented (used by PM) 
Allocate GDT Selectors 


DevHIp_PhysToGDTSelector Ox2E 


Convert phys addr to GDT sel 


DevHIp_RealToProt Ox2F 


DevHIp_EOI 0x31 


Change from real to protected mode 
Change from protected to real mode 


Send EOI to PIC 


DevHlp_UnPhysTovVirt 0x32 


mark completion of PhysToVirt 


DevHIp_TickCount 0x33 


DevHIp_FreeLIDEntry 0x35 


modify timer 
Obtain Logical ID 


Release Logical ID 


DevHlip_ABIOSCall 0x36 


Call ABIOS 


DevHIlp_ABlIOSCommonEntry 0x37 


DevHlIp_GetDeviceBlock 0x38 


DevHIp_RegisterStackUsag Ox3A 


Invoke Common Entry Point 
Get ABIOS Device Block 


Register for stack usage 


DevHIp_LogEntry 0x3B 


Place data in log buffer 


DevHIp_VideoPause 0x3C 


DevHlp_Save_Message 0x3D 


DevHIp_SegRealloc Ox3E 


Video pause on/off - D607 
Save msg in SysInit Message Table 


Realloc DD protect mode segment 


DevHIp_PutWaitingQueue Ox3F 


Put I/O request on waiting queue 


DevHIp_GetWaitingQueue 0x40 


DevHIp_PhysToSys 0x41 


DevHIp_PhysToSysHook 


Get I/O request from waiting queue 
Address conversion for the AOX 


Address conversion for the AOX 


DevHlIp_RegisterDeviceClass 


43 Register DC entry point 


DevHIp_RegisterPDD 


ia ical 


DevHIp_Beep 0x52 


Register PDD entry point with VDM 
manager for later PDD-VDD 
communication 


register PTD beep service entry point 
with kernel 


preempt beep service via PTD 


DevHlp_FreeGDTSelector 0x53 


Free allocated GDT selector 


256 os/2 Debugging 


Table 167 (Page 3 of 3). DevHlp Function Cross-Reference 


Function Name Code Description 
DevHIp_PhysToGDTSel 0x54 Convert Phys Addr to GDT sel with given 
access 
DevHlp_VMLock 0x55 Lock linear address range 
DevHIp_VMAlloc 0x56 Allocate memory 
DevHlp_VMFree 0x58 Free memory or mapping 
DevHIp_VMProcessToGlobal 0x59 Create global mapping to process 
memory 
memory 
DevHIp_VirtToLin 0x5B Convert virtual address to linear 
DevHlp_LinToGDTSelector 0x5C Convert linear address to virtual 
DevHIp_GetDesclnfo 0x5D Return descriptor information 
build pagelist array from lin addr 
DevHIp_PageListToLin Ox5F map page list array to lin addr 
DevHIp_PageListToGDTSelector 0x60 map page list array to GDT sel. 
DevHlip_RegisterTmrDD 0x61 Register TMR Device Driver. 


DevHlp_RegisterPerfCtrs 


DevHlp_AllocateCtxHook 


Register device driver perf. ctrs (PVW). 


oO;}o 
x< x< 
fora me?) 
wo}nrM 


Allocate a context hook 


DevHlp_FreeCtxHook 0x64 Free a context hook 

DevHIp_ArmCtxHook 0x65 Arm a context hook 

DevHIp_OpenEventSem 0x67 open an event semaphore 

DevHIp_CloseEventSem 0x68 close an event semaphore 

DevHIp_PostEventSem 0x69 post an event semaphore 

DevHIp_RegisterFreq 0x6B register PTD freq service entry point with 
kernel 

DevHlip_DynamicAPI 0x6C add a dynamic API 

DevHIp_ProcRun2 0x6D Unblock process via procrun2 
OEMINT13 

DevHIp_RegisterKrnlExit Ox6F Used to capture Kernel Exits F78693 

DevHIp_PMPostEventSem 0x70h PM Post Event Semaphore 


4.8 System Ordinal Cross-Reference 


The following table is a cross-reference for System Entry points by Ordinal 
number. 
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Table 168 (Page 1 of 22). System Ordinal Cross-Reference 


Ordinal 


Entry Point 


DOSICREATETHREAD 


DOSCWAIT 
DOSENTERCRITSEC 
DOSIEXECPGM 


DOSEXIT 


DOSEXITCRITSEC 
DOSEXITLIST 
DOSGETINFOSEG 


DOSGETPRTY 


10 


= 
= 


DOSKILLPROCESS 
DOSSETPRTY 
DOSPTRACE 


DOSHOLDSIGNAL 


DOSSETSIGHANDLER 
DOSFLAGPROCESS 
DOSMAKEPIPE 


DOSISYSSEMCLEAR 


=a/o/o3afa}afa}fal}]ua oloaolwNiloala!]pzAlowol]ro] = 
O!}lal NI ni al; ] wy] hr 


DOSISEMREQUEST 
DOSISYSSEMSET 


20 DOSSEMSETWAIT 

21 DOSISEMWAIT 

22 DOSMUXSEMWAIT 

24 DOSCREATESEM 

25 DOSOPENSEM 

26 DOSRESUMETHREAD 
DOSSUSPENDTHREAD 


28 DOSSETDATETIME 
29 DOSTIMERASYNC 
30 DOSTIMERSTART 


| 
= 


DOSTIMERSTOP 


32 DOSSLEEP 
33 DOSGETDATETIME 
34 DOSALLOCSEG 
DOSALLOCSHRSEG 
36 DOSGETSHRSEG 
37 DOSGIVESEG 
38 DOSREALLOCSEG 
40 DOSALLOCHUGE 


NO 
ol 
© 
e) 
Q 
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is) 
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Table 168 (Page 2 of 22). System Ordinal Cross-Reference 


Ordinal Entry Point 
4 DOSGETHUGESHIFT 
42 DOSREALLOCHUGE 
DOSCREATECSALIAS 
44 DOSLOADMODULE 
45 DOSGETPROCADDR 
46 DOSFREEMODULE 
DOSGETMODHANDLE 
48 DOSGETMODNAME 
49 DOSGETMACHINEMODE 
DOSBEEP 


= 


DOSCLIACCESS 
DOSDEVCONFIG 


DOSDEVIOCTL 


DOSSGSWITCH 
DOSSGSWITCHME 
DOSBUFRESET 


DOSCHDIR 


DOSCHGFILEPTR 
DOSCLOSE 
DOSDELETE 


DOSDUPHANDLE 


DOSFILELOCKS 
DOSFINDCLOSE 
DOSFINDFIRST 


DOSFINDNEXT 


DAI DI AIL DI DI DI ODI ODI aA al al; als las; ayas;ayjata 
NIL oO] a; R]oylyrmsl!} ol;]o;ral ni ny a; ] wy] pv Oo 


DOSMKDIR 
DOSMOVE 
68 DOSNEWSIZE 
69 DOSPORTACCESS 
70 DOSOPEN 
72 DOSQCURDISK 
73 DOSQFHANDSTATE 
74 DOSQFILEINFO 


N 
oa 


DOSQFILEMODE 


76 DOSQFSINFO 

77 DOSQHANDTYPE 
78 DOSQVERIFY 

80 DOSRMDIR 
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Table 168 (Page 3 of 22). System Ordinal Cross-Reference 


Ordinal Entry Point 
81 DOSSELECTDISK 
DOSSETFHANDSTATE 


co | © 
o}np 


DOSSETFILEINFO 


84 DOSSETFILEMODE 
85 DOSSETMAXFH 
86 DOSSETVERIFY 
88 DOSSYSTEMSERVICE 
89 DOSSETVEC 
DOSSYSTRACE 
1 DOSGETENV 


DOSGETVERSION 


DOSQTRACEINFO 


DOSGETPID 
DOSOPEN2 
DOSLIBINIT 


DOSSETFSINFO 


oOoO}O!] al aol] o!]oao]o]loao;!oa 
O;nN] oa} ay] eR] ow] Pp Oo 


DOSQPATHINFO 
DOSDEVIOCTL2 


100 DOSICANONICALIZE 
101 DOSSETFGND 
102 DOSSWAPTASKINIT 


104 DOSSETPATHINFO 
105 DOSSGSWITCHPROC2 
106 STRUCHECK 


108 DOSISETRELMAXFH 

109 DOSIDEVIOCTL 

110 DOS32FORCEDELETE 

114 DOS32KILLTHREAD 

112 DOSQUERYRASINFO 

113 DOS32DUMPPROCESS 

114 DOS32SUPPRESSPOPUPS 
DoeDy ENCE! 

119 DOSGETSTDA 

120 DOSERROR 

121 DOSGETSEG 
BEstorkses 

123 DOSUNLOCKSEG 
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Table 168 (Page 4 of 22). System Ordinal Cross-Reference 
Ordinal 


Entry Point 


124 


DOSSGSWITCHPROC 


125 


DOSIRAMSEMWAKE 


127 DOSMEMAVAIL 

128 DOSIRAMSEMREQUEST 

129 DOSPHYSICALDISK 

131 DOSISETCP 

132 DOSGLOBALSEG 

133 DOSPROFILE 

135 DOSHUGESHIFT 

136 DOSHUGEINCR 

137 DOSREAD 

139 DOSERRCLASS 

140 DOSSEMREQUEST 

144 DOSSEMCLEAR 

143 DOSSEMSET 

144 DOSEXECPGM 

145 DOSCREATETHREAD 

147 DOSSUBALLOC 

148 DOSSUBFREE 

149 DOSREADASYNC 

151 DOSSEARCHPATH 

152 DOSSCANENV 

153 DOSSETCP 
DOSQPROCSTATUS 

155 DOSGETRESOURCE 

156 DOSGETPPID 

157 DOSCALLBACK 

159 DOSRETFORWARD 

160 DOSR2STACKREALLOC 

161 DOSFSRAMSEMREQUEST 
DOSFSRAMSEMCLEAR 

163 DOSQAPPTYPE 
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Table 168 (Page 5 of 22). System Ordinal Cross-Reference 
Ordinal 


Entry Point 


164 


DOSSETPROCCP 


165 


DOSDYNAMICTRACE 
DOSQSYSINFO 
DOSIMAKENMPIPE 


DOSICALLNMPIPE 


DOSICONNECTNMPIPE 
DOSIDISCONNECTNMPIPE 
DOSIPEEKNMPIPE 


DOSIQNMPIPEINFO 


DOSIQNMPHANDSTATE 
DOSISETNMPHANDSTATE 
DOSITRANSACTNMPIPE 


DOSIWAITNMPIPE 


DOSISETNMPIPESEM 
DOSIQNMPIPESEMSTATE 
DOSIRAWREADNMPIPE 


DOSIRAWWRITENMPIPE 


DOSFSATTACH 
DOSQFSATTACH 
DOSFSCTL 


DOSFINDFIRST2 


DOSMKDIR2 
DOSFILEIO 
DOSFINDNOTIFYCLOSE 


DOSFINDNOTIFYFIRST 


DOSFINDNOTIFYNEXT 
DOSSETTRACEINFO 
DOSEDITNAME 


DOSLOGMODE 


DOSLOGENTRY 
DOSGETLOGBUFFER 
DOSLOGREGISTER 


DOSLOGREAD 


DOSFINDFROMNAME 
DOSOPLOCKRELEASE 
DOSOPLOCKWAIT 


DOSICOPY 


DOSCOPY 
DOSIQAPPTYPE 
DOSFORCEDELETE 


Table 168 (Page 6 of 22). System Ordinal Cross-Reference 
Ordinal 


Entry Point 


204 


DOSENUMATTRIBUTE 


DOSOPLOCKSHUTDOWN 
DOSSHUTDOWN 
DOSGETRESOURCE2 


DOSFREERESOURCE 


DOS32SETMAXFH 
DOS32SETVERIFY 
DOS32ERRCLASS 


DOS32ERROR 


DOSCREATEVDM 
DOSMAXPATHLEN 
DOSPAGESIZE 


DOSLOCALINFO 


DOSGLOBALINFO 
DOS32SETFILEINFO 
DOS32SETPATHINFO 


220 DOS32SETDEFAULTDISK 

221 DOS32SETFHSTATE 

222 DOS32SETFSINFO 

223 DOS32QUERYPATHINFO 

224 DOS32QUERYHTYPE 

225 DOS32QUERYVERIFY 

226 DOS32DELETEDIR 

227 DOS32SCANENV 

228 DOS32SEARCHPATH 

229 DOS32SLEEP 
DOSS2GETDATETIME 

231 DOS32DEVCONFIG 

232 DOS32ENTERCRITSEC 

233 DOS32EXITCRITSEC 

234 DOS32EXIT 

235 DOS32KILLPROCESS 

236 DOS32SETPRIORITY 

237 DOS32RESUMETHREAD 

238 DOS32SUSPENDTHREAD 

239 DOS32CREATEPIPE 

240 DOS32CALLNPIPE 

241 DOS32CONNECTNPIPE 

242 DOS32DISCONNECTNPIPE 

243 DOS32CREATENPIPE 
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Table 168 (Page 7 of 22). System Ordinal Cross-Reference 


Ordinal Entry Point 

244 DOS32PEEKNPIPE 

245 DOS32QUERYNPHSTATE 
DOS32RAWREADNPIPE 

247 DOS32RAWWRITENPIPE 

248 DOS32QUERYNPIPEINFO 

249 DOS32QUERYNPIPESEMSTATE 

250 DOS32SETNPHSTATE 

251 DOS32SETNPIPESEM 

252 DOS32TRANSACTNPIPE 

253 DOS32WAITNPIPE 

DOSS2RESETBUFFER 

255 DOS32SETCURRENTDIR 

256 DOS32SETFILEPTR 

257 DOS32CLOSE 

259 DOS32DELETE 

260 DOS32DUPHANDLE 

261 DOS32EDITNAME 

263 DOS32FINDCLOSE 

264 DOS32FINDFIRST 

265 DOS32FINDNEXT 

266 DOSOPENVDD 

267 DOSREQUESTVDD 

268 DOSCLOSEVDD 

269 DOS32FSATTACH 

270 DOS32CREATEDIR 

272 DOS32SETFILESIZE 

273 DOS320PEN 

274 DOS32QUERYCURRENTDIR 

275 DOS32QUERYCURRENTDISK 

276 DOS32QUERYFHSTATE 

277 DOS32QUERYFSATTACH 

278 DOS32QUERYFSINFO 

279 DOS32QUERYFILEINFO 

280 DOS32WAITCHILD 

281 DOS32READ 

282 DOS32WRITE 

283 DOS32EXECPGM 

284 DOS32DEVIOCTL 
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Ordinal Entry Point 

285 DOS32FSCTL 
DOS32BEEP 
DOS32PHYSICALDISK 
DOS32SETCP 

289 DOS32SETPROCESSCP 

290 DOS32STOPTIMER 

291 DOS32QUERYCP 

292 DOS32SETDATETIME 

293 THK32ALLOCBLOCK 

294 THK32FREEBLOCK 

296 DOS32EXITLIST 

297 DOS32ALLOCPROTECTEDMEM 

298 DOS32ALIASMEM 

300 DOS32ALLOCSHAREDMEM 

301 DOS32GETNAMEDSHAREDMEM 

302 DOS32GETSHAREDMEM 

303 DOS32GIVESHAREDMEM 

304 DOS32FREEMEM 

305 DOS32SETMEM 

306 DOS32QUERYMEM 

307 DOS32QUERYMEMSTATE 

308 DOS320PENVDD 

309 DOS32REQUESTVDD 

310 DOS32CLOSEVDD 

311 DOS32CREATETHREAD 

312 DOS32GETINFOBLOCKS 

313 DOSALLOCPROTSEG 

314 DOSALLOCSHRPROTSEG 

DOSALLOCPROTHUGE 

316 DOS32DYNAMICTRACE 

317 DOS32DEBUG 

318 DOS32LOADMODULE 

DOS32QUERYMODULEHANDLE 

320 DOS32QUERYMODULENAME 

321 DOS32QUERYPROCADDR 

322 DOS32FREEMODULE 

323 DOS32QUERYAPPTYPE 

324 DOS32CREATEEVENTSEM 
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Table 168 (Page 9 of 22). System Ordinal Cross-Reference 


Ordinal Entry Point 
325 DOS320PENEVENTSEM 
326 DOS32CLOSEEVENTSEM 
DOS32RESETEVENTSEM 
DOS32POSTEVENTSEM 
329 DOS32WAITEVENTSEM 
330 DOS32QUERYEVENTSEM 
331 DOS32CREATEMUTEXSEM 
332 DOS320PENMUTEXSEM 
333 DOS32CLOSEMUTEXSEM 
334 DOS32REQUESTMUTEXSEM 
DOS32RELEASEMUTEXSEM 
336 DOS32QUERYMUTEXSEM 
337 DOS32CREATEMUXWAITSEM 
338 DOS320PENMUXWAITSEM 
DOS32CLOSEMUXWAITSEM 
340 DOS32WAITMUXWAITSEM 
341 DOS32ADDMUXWAITSEM 
342 DOS32DELETEMUXWAITSEM 
343 DOS32QUERYMUXWAITSEM 
344 DOS32SUBSETMEM 
345 DOS32SUBALLOCMEM 
346 DOS32SUBFREEMEM 
347 DOS32SUBUNSETMEM 
348 DOS32QUERYSYSINFO 
349 DOS32WAITTHREAD 
350 DOS32ASYNCTIMER 
DOSS2STARTTIMER 
352 DOS32GETRESOURCE 
353 DOS32FREERESOURCE 
354 DOS32SETEXCEPTIONHANDLER 
355 DOS32UNSETEXCEPTIONHANDLER 
356 DOS32RAISEEXCEPTION 
357 DOS32UNWINDEXCEPTION 
358 DOS32QUERYPAGEUSAGE 
359 DOSQUERYMODFROMCS 
360 DOS32QUERYMODFROMEIP 
361 DOSFPDATAAREA 
362 DOS32TMRQUERYFREQ 
363 DOS32TMRQUERYTIME 
364 DOS32ALIASPERFCTRS 
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Ordinal Entry Point 

365 DOS32CONFIGUREPERF 
DOS32DECONPERF 
DOS32REGISTERPERFCTRS 
DOS32QUERYSYSSTATE 

369 DOS32FLATCS 

370 DOS32FLATDS 

371 DOS32QUERYABIOSSUPPORT 

372 DOS32ENUMATTRIBUTE 

373 DOS32QUERYDOSPROPERTY 

374 DOS32SETDOSPROPERTY 

DOSQUERYDOSPROPERTY 

376 DOSSETDOSPROPERTY 

377 DOS32PROFILE 

378 DOS32SETSIGNALEXCEPTIONFOC 

DOS32SENDSIGNALEXCEPTION 

380 DOS32ENTERMUSTCOMPLETE 

381 DOS32EXITMUSTCOMPLETE 

382 DOS32SETRELMAXFH 

383 MSGPUTMESSAGE 

384 MSGTRUEGETMESSAGE 

385 MSGINSMESSAGE 

386 MSG32INSERTMESSAGE 

387 MSG32PUTMESSAGE 

388 MSG32TRUEGETMESSAGE 

389 MSGIQUERYMESSAGECP 

390 MSG32IQUERYMESSAGECP 

392 NLSGETCOLLATE 

393 NLSGETCTRYINFO 

394 NLSGETDBCSEV 

395 NLS32QUERYCTRYINFO 

396 NLS32QUERYDBCSENV 

397 NLS32MAPCASE 

398 NLS32QUERYCOLLATE 

399 NPIPEMAKENMPIPE 

400 NPIPEQNMPIPEINFO 

401 NPIPECONNECTNMPIPE 

402 NPIPEDISCONNECTNMPIPE 

403 NPIPEQNMPHANDSTATE 

404 NPIPESETNMPHANDSTATE 
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Table 168 (Page 11 of 22). System Ordinal Cross-Reference 


Ordinal 


Entry Point 


405 


NPIPEPEEKNMPIPE 


406 


NPIPEWAITNMPIPE 
NPIPETRANSACTNMPIPE 
NPIPECALLNMPIPE 


409 NPIPERAWREADNMPIPE 

410 NPIPERAWWRITENMPIPE 
411 NPIPESETNMPIPESEM 

412 NPIPEQNMPIPESEMSTATE 
413 HPFSSTARTLAZYWRITER 
414 QUEINSTANCEDATA 

416 DOS32ICACHEMODULE 

417 DOS32REPLACEMODULE 
418 DOS32ACKNOWLEDGESIGNALEXCG 
420 DOSTMRQUERYFREQ 

421 DOSTMRQUERYTIME 

422 DOSREGISTERPERFCTRS 
423 DOSFLATTOSEL 

424 DOSSELTOFLAT 

425 DOS32FLATTOSEL 

426 DOS32SELTOFLAT 

427 DOSIODELAYCNT 

428 DOS32SETFILELOCKS 

429 DOS32CANCELLOCKREQUEST 
430 LOGOPEN 

432 LOGADDENTRIES 

433 LOGGETENTRIES 

434 LOGSETSTATE 

435 LOGSETNAME 

436 LOGQUERYSTATE 

437 DOSOPENCHANGENOTIFY 
438 DOSRESETCHANGENOTIFY 
DOSCLOSEGHANGENOTIFY 
440 DOS320PENCHANGENOTIFY 
441 DOS32RESETCHANGENOTIFY 
442 DOS32CLOSECHANGENOTIFY 
443 DOSQUERYABIOSSUPPORT 
444 DOS32FORCESYSTEMDUMP 
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Ordinal 


Entry Point 


454 


DOS32ALLOCTHREADLOCALMEMORY 


455 


DOS32FREETHREADLOCALMEMORY 
DOS32VERIFYPIDTID 
PTDA_LANMAN_SEC 


465 PTDA_PID 
466 SAS_SEL 

468 TCB_OPFLAGS 

469 TCB_NEWFLAGS 

470 TCB_USER_ID 

471 TCB_PROC_ID 

472 TCB_FSHARING 

473 TCB_SRVATTRIB 

474 TCB_ALLOWED 

475 TCB_PRTCB 

476 TCB_NUMBER 

477 TCB_THISSFT 

478 TCB_THISCDS 

479 TKOPTDA 

480 PTDA_CRITSEC 

481 PTDA_HOLDSIGCNT 
482 PTDA_PPTDAPARENT 
483 PTDA_PGDATA 

484 PTDA_HANDLE 

485 PTDA_MODULE 

486 PTDA_LDTHANDLE 
PTDA_CODEPAGE_TAG 
488 PTDA_JFN_LENGTH 
489 PTDA_JFN_PTABLE 
490 PTDA_JFN_FLG PTR 
PTDA_EXTERR_LOCUS 
492 PTDA_EXTERR 

493 PTDA_EXTERR_ ACTION 
494 PTDA_EXTERR_CLASS 
496 PTDA_PROCTYPE 

497 PTDA_CURRTCB 

498 PTDA_CURRTSD 

499 PTDA_SIGNATURE 
545 DOS32EXCEPTIONCALLBACK 
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Table 168 (Page 13 of 22). System Ordinal Cross-Reference 


Ordinal Entry Point 
548 DOS32R3EXCEPTIONDISPATCHER 
DOSLIBIDISP 


DOSLIBIDISP16 


551 DOSLIBIDISP32 

552 DOSR3EXITADDR 

553 DOS32R3EXITADDR 

554 DOS32IREAD 

556 DOS32IWRITE 

565 DOSISETFILEINFO 

566 DOSISETPATHINFO 
DOSIFINDNEXT 

572 DOS32QUERYRESOURCESIZE 
573 DOSQUERYRESOURCESIZE 
574 DOSPMSEMWAIT 
DOSPMMUXSEMWATT 

576 THK16_UNITHUNK 

577 HT16_STARTUP 

580 DOS32INITIALIZEPORTHOLE 
582 DOS32QUERYHEADERINFO 
583 DOSINITIALIZEPORTHOLE 
584 DOSQUERYHEADERINFO 
585 MON32MONREAD 

586 DOS32QUERYPROCTYPE 
587 DOSQUERYPROCTYPE 

588 MON32MONWRITE 

589 DOSISIGDISPATCH 
DOSG2DLLTERMDISP 

594 DOS32IRAISEEXCEPTION 
597 DOS32IQUERYFHSTATE 

598 DOS32ISETFHSTATE 

599 DOSLDTSEL 

600 DOS32R3FRESTOR 

601 DOSIFINDFIRST 

615 DOS32IPROTECTWRITE 
DOSIPROTECTSETFILEINFO 
618 DOS32IPROTECTSETFILEINFO 
619 DOS32IPROTECTSETFHSTATE 
620 DOS32IPROTECTQUERYFHSTATE 
621 DOS32PROTECTSETFILEPTR 
622 DOSPROTECTCLOSE 
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Ordinal 


Entry Point 


623 


DOSPROTECTFILEIO 


DOSPROTECTFILELOCKS 
DOSIPROTECTREAD 
DOSIPROTECTWRITE 


627 DOSPROTECTNEWSIZE 
628 DOSPROTECTOPEN 

629 DOSPROTECTQFHANDSTATE 
630 DOSPROTECTSETFHANDSTATE 
631 DOSPROTECTOFILEINFO 

632 DOSPROTECTSETFILEINFO 
DOSPROTECTCHGFILEPTR 

635 DOSPROTECTENUMATTRIBUTE 
636 DOS32PROTECTENUMATTRIBUTE 
637 DOS32PROTECTOPEN 
DOS32PROTECTCLOSE 

639 DOS32PROTECTSETFILELOCKS 
640 DOS32PROTECTSETFILESIZE 
641 DOS32PROTECTREAD 

642 DOS32PROTECTWRITE 

643 DOS32PROTECTSETFILEINFO 
644 DOS32PROTECTSETFHSTATE 
645 DOS32PROTECTQUERYFHSTATE 
646 DOS32PROTECTQUERYFILEINFO 
647 DOS32IPROTECTREAD 

649 MSGCLOSEMESSAGEFILE 

650 DOSLDRDIRTYWORKER 
DOS16LDRDIRTYWORKER 

661 QUEDOS32READQUEUE 

662 QUEDOS32PURGEQUEUE 

663 QUEDOS32CLOSEQUEUE 

664 QUEDOS32QUERYQUEUE 

665 QUEDOS32PEEKQUEUE 

666 QUEDOS32WRITEQUEUE 

667 QUEDOS320PENQUEUE 

668 QUEDOS32CREATEQUEUE 

669 SMGDOS32STARTSESSION 
670 SMGDOS32SELECTSESSION 
671 SMGDOS32SETSESSION 

672 SMGDOS32STOPSESSION 

673 SMGREGISTERNOTIFICATION 
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Table 168 (Page 15 of 22). System Ordinal Cross-Reference 


Ordinal Entry Point 

674 QUEDOSREADQUEUE 
675 QUEDOSPURGEQUEUE 
676 QUEDOSCLOSEQUEUE 
677 QUEDOSQUERYQUEUE 
678 QUEDOSPEEKQUEUE 

679 QUEDOSWRITEQUEUE 
680 QUEDOSOPENQUEUE 

681 QUEDOSCREATEQUEUE 
682 CHRDOSSMGETME 

683 CHRDOSSMFREEMEM 
CHRDOSSMGETSGCB 
685 CHRDOSSMINITSGCB 
686 SMGDOSSMSGDOPOPUP 
687 SMGDOSSMSWITCH 
SMGDOSSMSERVEAPPREQ 
689 SMGDOSGETTIMES 

690 SMGDOSSMSETTITLE 

691 SMGDOSSCRUNLOCK 
692 SMGDOSSMDOAPPREQ 
693 SMGDOSSTOPSESSION 
694 SMGDOSSELECTSESSION 
695 SMGDOSSCRLOCK 
fee = s—s—~—~—<—SsSsSYsS SMG DOSSAVREDRAW WAIT 
697 SMGDOSSAVREDRAWUNDO 
698 SMGDOSSMSGENDPOPUP 
699 SMGDOSSETSESSION 
SMGDOSSETMNLOCKTIME 
701 SMGDOSMODEUNDO 

702 SMGDOSSTARTSESSION 
703 SMGDOSSMGETSTATUS 
704 SMGDOSSMMODEWAIT 
705 SMGDOSSMTERMINATE 
706 SMGDOSSMGETAPPREQ 
707 SMGDOSSMINITIALIZE 
708 SMGDOSSMSTART 

709 SMGDOSSMPARENTSWITCH 
710 SMGDOSSMPAUSE 

711 SMGDOSSMHDEINIT 
SMGDOSSMPMPRESENT 
713 SMGDOSSMREGISTERDD 
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Ordinal Entry Point 

714 SMGDOSSMNOTIFYDD 

715 SMGDOSSMNOTIFYDD2 
SMGDOSSMOPENDD 
SMGDOSSMSETSESSIONTYPE 

718 CHRBASEINIT 

719 MOUDOSGETPTRSHAPE 

720 MOUDOSSETPTRSHAPE 

721 MOUDOSGETNUMMICKEYS 

722 MOUDOSGETTHRESHOLD 

723 MOUDOSSHELLINIT 

MOUDOSGETSCALEFACT 

725 MOUDOSFLUSHQUE 

726 MOUDOSGETNUMBUTTONS 

727 MOUDOSCLOSE 

MOUDOSSETTHRESHOLD 

729 MOUDOSSETSCALEFACT 

730 MOUDOSGETNUMQUEEL 

731 MOUDOSDEREGISTER 

732 MOUDOSGETEVENTMASK 

733 MOUDOSSETEVENTMASK 

734 MOUDOSOPEN 

735 MOUDOSREMOVEPTR 

736 MOUDOSGETPTRPOS 

737 MOUDOSREADEVENTQUE 

738 MOUDOSSETPTRPOS 

739 MOUDOSGETDEVSTATUS 

741 MOUDOSREGISTER 

742 MOUDOSSETDEVSTATUS 

743 MOUDOSDRAWPTR 

744 MOUDOSINITREAL 

745 KBDDOSSETCUSTXT 

746 KBDDOSPROCESSINIT 

747 KBDDOSGETCP 

748 KBDDOSCHARIN 

749 KBDDOSSETCP 

750 KBDDOSLOADINSTANCE 

751 KBDDOSSYNCH 

752 KBDDOSREGISTER 

753 KBDDOSSTRINGIN 
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Table 168 (Page 17 of 22). System Ordinal Cross-Reference 


Ordinal Entry Point 

754 KBDDOSGETSTATUS 

755 KBDDOSSETSTATUS 
KBDDOSGETFOCUS 
KBDDOSFLUSHBUFFER 

758 KBDDOSXLATE 

759 KBDDOSSWITCHFGND 

760 KBDDOSSHELLINIT 

761 KBDDOSCLOSE 

762 KBDDOSFREEFOCUS 

763 KBDDOSFREE 

KBDDOSDEREGISTER 

765 KBDDOSSETFGND 

766 KBDDOSPEEK 

767 KBDDOSOPEN 

769 KBDDOSSETHWID 

770 VIODOSENDPOPUP 

771 VIODOSGETPHYSBUF 

772 VIODOSGETANSI 

773 VIODOSFREE 

774 VIODOSSETANSI 

775 VIODOSDEREGISTER 

776 VIODOSSCROLLUP 

777 VIODOSPRTSC 

778 VIODOSGETCURPOS 

779 VIODOSWRTCELLSTR 

781 VIODOSSCROLLRT 

782 VIODOSWRTCHARSTR 

783 VIODOSAVS_ PRTSC 

784 VIODOSSETCURPOS 

785 VIODOSSRFUNBLOCK 

786 VIODOSSRFBLOCK 

787 VIODOSSCRUNLOCK 

788 VIODOSWRTTTY 

789 VIODOSSAVE 

790 VIODOSGETMODE 

791 VIODOSSETMODE 

792 VIODOSSCRLOCK 

793 VIODOSREADCELLSTR 
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Ordinal 


Entry Point 


794 


VIODOSSAVREDRAWWAIT 


795 


VIODOSWRTNATTR 
VIODOSGETCURTYPE 
VIODOSSAVREDRAWUNDO 


798 VIODOSGETFONT 
799 VIODOSREADCHARSTR 
800 VIODOSGETBUF 

801 VIODOSSETCURTYPE 

802 VIODOSSETFONT 

803 VIODOSHETINIT 
VIODOSMODEUNDO 

805 VIODOSSSWSWITCH 

806 VIODOSMODEWAIT 

807 VIODOSAVS_ PRTSCTOGGLE 
808 VIODOSGETCP 

809 VIODOSRESTORE 

810 VIODOSSETCP 

811 VIODOSSHOWBUF 
VIODOSSCROLLLF 

813 VIODOSREGISTER 

814 VIODOSGETCONFIG 

815 VIODOSSCROLLDN 
VIODOSWRTCHARSTRATT 
817 VIODOSGETSTATE 

818 VIODOSPRTSCTOGGLE 

819 VIODOSSETSTATE 
VIODOSWRTNCELL 

821 VIODOSWRTNCHAR 

822 VIODOSSHELLINIT 

823 VIODOSASSOCIATE 

824 VIODOSCREATEPS 

825 VIODOSDELETESETID 

826 VIODOSGETDEVICECELLSIZE 
827 VIODOSGETORG 

828 VIODOSCREATELOGFONT 
829 VIODOSDESTROYPS 

830 VIODOSQUERYSETIDS 

831 VIODOSSETORG 

832 VIODOSQUERYFONTS 

833 VIODOSSETDEVICECELLSIZE 
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Table 168 (Page 19 of 22). System Ordinal Cross-Reference 


Ordinal 


Entry Point 


834 


VIODOSSHOWPS 


835 


VIODOSGETPSADDRESS 
VIODOSQUERYCONSOLE 
VIODOSREDRAWSIZE 


838 VIODOSGLOBALREG 
839 XVIODOSSETCASTATE 
840 XVIODOSCHECKCHARTYPE 
841 XVIODOSDESTROYCA 
842 XVIODOSCREATECA 
843 VIOCDOSHECKCHARTYPE 
XVIODOSGETCASTATE 
845 BVSDOSMAIN 

846 BVSDOSREDRAWSIZE 
847 BVSDOSGETPTRDRAWNAME 
849 ANSIDOSKEYDEF 

850 ANSIDOSINTERP 

851 BKSDOSMAIN 

852 BMSDOSMAIN 

853 MOUDOSGETHOTKEY 
854 MOUDOSSETHOTKEY 
855 SMGDOSSMSYSINIT 
856 SMGQHKEYBDHANDLE 
857 SMGQHMOUSEHANDLE 
858 CHRQueueRamSem 
859 CHRArray 

861 CHRinitialized 

862 CHRArraySize 

863 CHRBVSGLOBAL 

864 CHRSMGINSTANCE 
865 CHRBVHINSTANCE 
115 THK32ALLOCMEM 

116 THK32FREEMEM 
THK32ALLOCSTACK 
262 THK382FREESTACK 
546 THK382STRLEN 

547 THK32_UNITHUNK 
578 HT16_CLEANUP 

579 HT32_STARTUP 
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Ordinal Entry Point 
581 HT32_CLEANUP 
DOS32PMPOSTEVENTSEM 


DOS32PMWAITEVENTSEM 
DOS32PMREQUESTMUTEXSEM 


DOS32PMWAITMUXWAITSEM 


596 DOS32PM16SEMCHK 

867 THK32FREEALIAS 

868 THK32ALLOCVARLEN 
869 THK32HANDLEBOUNDARY 
870 THK32HANDLESTRING 
871 THK32DEALLOC 

872 THK32XHNDLR 

873 DOS32SETEXTLIBPATH 
874 DOS32QUERYEXTLIBPATH 
875 DOS32PM16SEMRST 

876 DOS32SYSCTL 

998 DOSSETEXTLIBPATH 
f999——s—s—sSSs|s«éDOSQUERYEXTLIBPATH 
1000 T32EXITLIST 

1001 T32ALLOCPROTECTEDMEM 
1002 T32ALIASMEM 

1004 T32ALLOCSHAREDMEM 
1005 T32GETNAMEDSHAREDMEM 
1006 T32GETSHAREDMEM 
T32GIVESHAREDMEM 
1008 T32FREEMEM 

1009 T32SETMEM 

1010 T32QUERYMEM 
T32QUERYMEMSTATE 
1012 T320PENVDD 

1013 T32REQUESTVDD 

1014 T32CLOSEVDD 
T32CREATETHREAD 

1016 T32DYNAMICTRACE 
1017 T32DEBUG 

1018 T32QUERYPROCADDR 
T32CREATEEVENTSEM 
1020 T320PENEVENTSEM 
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Table 168 (Page 21 of 22). System Ordinal Cross-Reference 


Ordinal Entry Point 

1021 T32CLOSEEVENTSEM 
1022 T32RESETEVENTSEM 
T32POSTEVENTSEM 
1024 T32WAITEVENTSEM 
1025 T32QUERYEVENTSEM 
1026 T32CREATEMUTEXSEM 
T320PENMUTEXSEM 
1028 T32CLOSEMUTEXSEM 
1029 T32REQUESTMUTEXSEM 
1030 T32RELEASEMUTEXSEM 
T32QUERYMUTEXSEM 
1032 T32CREATEMUXWAITSEM 
1033 T320PENMUXWAITSEM 
1034 T32CLOSEMUXWAITSEM 
T32WAITMUXWAITSEM 
1036 T32ADDMUXWAITSEM 
1037 T32DELETEMUXWAITSEM 
1038 T32QUERYMUXWAITSEM 
T32QUERYSYSINFO 
1040 T32WAITTHREAD 

1041 T32GETRESOURCE 

1042 T32FREERESOURCE 
T32EXCEPTIONCALLBACK 
1044 T32QUERYPAGEUSAGE 
1045 T32FORCESYSTEMDUMP 
1046 TI32ASYNCTIMER 
TI32STARTTIMER 

1048 T32QUERYABIOSSUPPORT 
1049 T32QUERYMODFROMEIP 
1050 T32ALIASPERFCTRS 
T32CONFIGUREPERF 
1052 T32DECONPERF 

1053 T32REGISTERPERFCTRS 
1054 T32QUERYSYSSTATE 
1056 T32IWRITE 

1057 T32TMRQUERYFREQ 
1058 T32TMRQUERYTIME 
1060 T32IMONWRITE 


278 = os/2 Debugging 


Table 168 (Page 22 of 22). System Ordinal Cross-Reference 


Ordinal Entry Point 
1061 T32QUERYRESOURCESIZE 
1062 T32PROFILE 


T32SETSIGNALEXCEPTIONFOC 
1064 T32SENDSIGNALEXCEPTION 
1065 T32STARTTIMER 
1066 T32STOPTIMER 
1068 T32INITIALIZEPORTHOLE 
1069 T32QUERYHEADERINFO 
1070 T32QUERYPROCTYPE 

T32IEXITMUSTCOMPLETE 
1072 T32ICACHEMODULE 
1073 T32DLLTERM 
1074 T32IRAISEEXCEPTION 

T32ACKNOWLEDGESIGNALEXC 
1076 T32QUERYDOSPROPERTY 
1077 T32SETDOSPROPERTY 
1078 T32SETFILELOCKS 

T32CANCELLOCKREQUEST 
1080 T32KILLTHREAD 
1081 TQUERYRASINFO 
1082 T32DUMPPROCESS 

T32SUPPRESSPOPUPS 
1084 T32IPROTECTWRITE 
1085 T32PROTECTSETFILELOCKS 
1086 T32IPROTECTREAD 

T32PMPOSTEVENTSEM 
1088 T32PMWAITEVENTSEM 
1089 T32PMREQUESTMUTEXSEM 
1090 T32PMWAITMUXWAITSEM 
1092 T32ALLOCTHREADLOCALMEMORY 
1093 T32F REETHREADLOCALMEMORY 
1094 T32SETEXTLIBPATH 

T32QUERYEXTLIBPATH 
1096 T32PM16SEMRST 
1097 T32VERIFYPIDTID 
1098 T32SYSCTL 
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4.9 OS/2 FixPak to Build Level Cross-Reference 


The following table cross-references some of the public FixPaks and General 
Availability versions of OS/2 with their internal kernel build level. 


Note: Some FixPaks use the same kernel build level when updates are confined 
to modules other than OS2KRNL. 


Table 169. FixPak to Build Level Cross-Reference 

Version Build 
2.11 GA 6.617 
Warp GA 8.162 
Warp Connect 8.209 
Warp for Windows Connect 8.200 
XR_W005 8.213B 
XR_W007 8.230 
XR_W008 8.230 
XR_W009 8.234 
XR_W010 8.234 
XR_WO011 8.235 
XR_W012 8.236 
XR_W013 8.237 
XR_W014 8.238 
XR_W016 8.240 
XR_W017 8.240 
XR_A076 6.653 
XR_A080 6.653 
XR_A090 6.656 
XR_A092 6.658 
XR_A095 6.661 
XR_A096 6.660 
XR_BO97 6.664 
XR_BO98 6.665 
XR_BO99 6.667 
XR_B100 6.668 
XR_B101 6.669 
XR_B102 6.670 
XR_B103 6.671 
XR_B104 6.672 
XR_B105 6.673 
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